Quickstart¶

Get a fully functional Convergio AI instance running on your machine.

1. Clone the repository¶

git clone https://github.com/InstinctBits/convergioai.git
cd convergioai

2. Install dependencies¶

npm install

3. Configure environment¶

cp .env.example .env

Edit .env with your credentials:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/convergioai

# AI
ANTHROPIC_API_KEY=sk-ant-...

# Email (IMAP/SMTP)
IMAP_HOST=imap.gmail.com
IMAP_PORT=993
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
EMAIL_USER=your@email.com
EMAIL_PASS=your-app-password

# JWT
JWT_SECRET=your-secret-key

4. Initialize the database¶

npm run db:init

This runs the SQL schemas (schema.sql, schema-settings.sql, schema-calendar.sql, schema-streamboost.sql) to create all required tables.

5. Start the development servers¶

npm run dev:all

This starts both servers concurrently:

6. Access the dashboard¶

Open http://localhost:5173 in your browser. You'll see the login page.

A demo account is seeded automatically:

What's next?¶

• Installation — Detailed setup including Docker and n8n
• Configuration — All environment variables and options
• Features — Explore what Convergio AI can do