Installation - rapida.ai documentation

Docker (Recommended)
Manual Setup

The fastest way to get Rapida running with all services configured automatically.

Prerequisites

Docker Desktop or Docker Engine (v20.10+)
Docker Compose (v2.0+) - included with Docker Desktop
4GB+ RAM available
10GB free disk space

Installation Steps

Install Docker and Docker Compose

# Using Homebrew
brew install --cask docker

# Or download from Docker website
# https://www.docker.com/products/docker-desktop

# Then open Docker.app from Applications folder.

Verify Installation

# Check Docker
docker --version
# Expected: Docker version 20.10+

# Check Docker Compose
docker compose version
# Expected: version 2.0+

# Test Docker
docker run hello-world

Clone Repository

git clone https://github.com/rapidaai/voice-ai.git
cd voice-ai

Run Setup

# Create data directories and set permissions
make setup-local

This creates:

~/rapida-data/assets/db - PostgreSQL
~/rapida-data/assets/redis - Redis
~/rapida-data/assets/opensearch - OpenSearch

Start Rapida

make up-all

Access Dashboard

Open your browser:

Dashboard: http://localhost:3000
API Gateway: http://localhost:8080

Verify Services Are Running

make ps-all

All containers should show Up status.

View Logs

# All services
make logs-all

# Specific service
make logs-web
make logs-assistant
make logs-postgres

Stop Services

# Stop all services
make down-all

# Stop specific service
docker compose stop web-api

Using Existing Infrastructure

If you already have PostgreSQL, Redis, or OpenSearch running, you can skip those services.

Example: Use Existing PostgreSQL

Edit docker-compose.yml and comment out or remove the postgres service:

# postgres:
#   image: postgres:15
#   ...

Update PostgreSQL environment variables in docker/web-api/.web.env:

POSTGRES__HOST=host.docker.internal  # Point to host machine
POSTGRES__PORT=5432
POSTGRES__DB_NAME=web_db
POSTGRES__AUTH__USER=your_user
POSTGRES__AUTH__PASSWORD=your_password

Example: Use Existing Redis

Comment out Redis in docker-compose.yml:

# redis:
#   image: redis:7
#   ...

Update Redis settings in service .env files:

REDIS__HOST=host.docker.internal  # Your Redis host
REDIS__PORT=6379

Example: Use Existing OpenSearch

Comment out OpenSearch in docker-compose.yml:

# opensearch:
#   image: opensearchproject/opensearch:2.11
#   ...

Update OpenSearch settings:

OPENSEARCH__HOST=host.docker.internal
OPENSEARCH__PORT=9200

Next Steps

After installation:

Configure Services - Set up API keys and integrations
Services Overview - Understand what each service does
Troubleshooting - Fix common issues

For developers who prefer not to use Docker. This requires installing each component individually.

Prerequisites

# Install Homebrew first (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install required tools
brew install [email protected] [email protected] node@22 postgresql@15 redis opensearch

# Verify installations
go version      # go1.25+
python --version # python3.11+
node --version  # node22+

PostgreSQL

# Start PostgreSQL
brew services start postgresql@15

# Verify it's running
psql --version

Create databases:

# Connect to PostgreSQL
psql postgres

# Run these SQL commands:
CREATE USER rapida_user WITH PASSWORD 'rapida_db_password';
CREATE DATABASE web_db OWNER rapida_user;
CREATE DATABASE assistant_db OWNER rapida_user;
CREATE DATABASE integration_db OWNER rapida_user;
CREATE DATABASE endpoint_db OWNER rapida_user;
GRANT ALL PRIVILEGES ON DATABASE web_db TO rapida_user;
GRANT ALL PRIVILEGES ON DATABASE assistant_db TO rapida_user;
GRANT ALL PRIVILEGES ON DATABASE integration_db TO rapida_user;
GRANT ALL PRIVILEGES ON DATABASE endpoint_db TO rapida_user;
\q

Redis

# Start Redis
brew services start redis

# Verify it's running
redis-cli ping
# Should return: PONG

OpenSearch

# Install OpenSearch (requires Java)
brew tap opensearch-project/opensearch
brew install opensearch

# Start OpenSearch
opensearchctl start

# Verify it's running
curl -s http://localhost:9200/_cluster/health | jq .

Clone Repository

git clone https://github.com/rapidaai/voice-ai.git
cd voice-ai

Install Assistant API Dependencies

The Assistant API requires RNNoise and Azure Speech SDK for audio processing.

# Install RNNoise
brew install autoconf automake libtool pkg-config
git clone https://github.com/rapidaai/rnnoise.git
cd rnnoise
./autogen.sh
./configure --prefix=/usr/local
make -j$(sysctl -n hw.ncpu)
sudo make install
cd ..

# Install Azure Speech SDK
wget -O SpeechSDK-macOS.tar.gz https://aka.ms/csspeech/macosbinary
mkdir -p ~/opt/azure-speech-sdk
tar --strip 1 -xzf SpeechSDK-macOS.tar.gz -C ~/opt/azure-speech-sdk
rm SpeechSDK-macOS.tar.gz

# Add to shell profile (~/.zprofile or ~/.bash_profile)
export LD_LIBRARY_PATH="$HOME/opt/azure-speech-sdk/lib:$LD_LIBRARY_PATH"
export DYLD_LIBRARY_PATH="$HOME/opt/azure-speech-sdk/lib:$DYLD_LIBRARY_PATH"

Set Up Go Services

# Build all Go services
make build-all

# Or build individually
make build-web
make build-assistant
make build-integration
make build-endpoint

Set Up Python Services

# Create Python virtual environment
cd api/document-api
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Note: rn_noise is included in requirements

Set Up Frontend

cd ui

# Install dependencies
yarn install

# Build CSS
yarn build:css

Start Services (in separate terminals)

go run ./cmd/web/main.go

Step 7: Access Dashboard

Open your browser:

Dashboard: http://localhost:3000
API Gateway: http://localhost:8080 (requires Nginx setup)

Using Existing Infrastructure

If you already have PostgreSQL, Redis, or OpenSearch installed:

Skip PostgreSQL Installation

Just create the databases:

psql -h localhost -U your_user -d postgres
CREATE DATABASE web_db;
CREATE DATABASE assistant_db;
CREATE DATABASE integration_db;
CREATE DATABASE endpoint_db;

Skip Redis Installation

Just update the Redis URL:

export REDIS_URL="redis://your-redis-host:6379/0"

Skip OpenSearch Installation

Update OpenSearch host:

export OPENSEARCH_HOST="your-opensearch-host:9200"

Troubleshooting

Services Won’t Start

Check if ports are available:

lsof -i :9001  # For web-api
lsof -i :5432  # For PostgreSQL

Check PostgreSQL logs:

# macOS
tail -f /usr/local/var/log/postgres.log

# Linux
sudo journalctl -u postgresql -f

Connection Issues

Verify PostgreSQL is running:

psql -h localhost -U rapida_user -d web_db -c "SELECT 1;"

Verify Redis is running:

redis-cli ping

Verify OpenSearch is running:

curl -s http://localhost:9200/_cluster/health

Next Steps

After installation:

Configure Services - Set up API keys and integrations
Services Overview - Understand what each service does
Troubleshooting - Fix common issues

Getting Started

Services

​Prerequisites

​Installation Steps

​Verify Services Are Running

​View Logs

​Stop Services

​Using Existing Infrastructure

​Example: Use Existing PostgreSQL

​Example: Use Existing Redis

​Example: Use Existing OpenSearch

​Next Steps

​Prerequisites

​PostgreSQL

​Redis

​OpenSearch

​Clone Repository

​Install Assistant API Dependencies

​Set Up Go Services

​Set Up Python Services

​Set Up Frontend

​Start Services (in separate terminals)

​Step 7: Access Dashboard

​Using Existing Infrastructure

​Skip PostgreSQL Installation

​Skip Redis Installation

​Skip OpenSearch Installation

​Troubleshooting

​Services Won’t Start

​Connection Issues

​Next Steps

Prerequisites

Installation Steps

Verify Services Are Running

View Logs

Stop Services

Using Existing Infrastructure

Example: Use Existing PostgreSQL

Example: Use Existing Redis

Example: Use Existing OpenSearch

Next Steps

Prerequisites

PostgreSQL

Redis

OpenSearch

Clone Repository

Install Assistant API Dependencies

Set Up Go Services

Set Up Python Services

Set Up Frontend

Start Services (in separate terminals)

Step 7: Access Dashboard

Using Existing Infrastructure

Skip PostgreSQL Installation

Skip Redis Installation

Skip OpenSearch Installation

Troubleshooting

Services Won’t Start

Connection Issues

Next Steps