Skip to main content

Prerequisites

Required Software

1

Docker Desktop

2

Node.js 18+

3

Git

PostgreSQL, Redis, and ChromaDB run in Docker containers. No manual installation needed.

Project Setup

1. Clone Repository

2. Infrastructure Setup (Docker)

3. Run Database Migrations

Expected tables include:
  • users, organizations, organization_members
  • bots, bot_prompt_versions, conversations, messages, token_usage
  • ai_models, message_attachments, custom_voices
  • knowledge_bases, kb_sources, kb_documents, kb_document_chunks, kb_agent_links, kb_analytics

4. Install Dependencies

5. Environment Configuration

Edit .env with your API keys:

6. Start Services

Verification Checklist

Database

Services

Redis

Frontend

  1. Open http://localhost:3000
  2. Register a new account
  3. Create a test agent
  4. Send a test message
  5. Verify chat works with OpenRouter

API Keys to Obtain

Required

Optional

Quick Reference