Development Environment

For local development, you run the app code directly with pnpm against a Supabase project. Nothing else runs in Docker.

Prerequisites

Node.js 20+
pnpm — npm install -g pnpm
A Supabase project
An AI provider key: OpenRouter (runs every model) or Anthropic

Step 1: Clone and install

git clone https://github.com/NousC/opennous.git
cd opennous
pnpm install

Step 2: Configure environment

cp .env.example .env

Fill in .env:

# Supabase — Settings → API
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key

# AI: one OpenRouter key runs every model; or ANTHROPIC_API_KEY for claude- ids
OPENROUTER_API_KEY=sk-or-...

# Generate with: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
ENCRYPTION_KEY=

Step 3: Run the database schema

Required on first setup. Open your Supabase project → SQL Editor → paste and run supabase/schema.sql.

Step 4: Start the app

pnpm dev

Starts all services in parallel:

Service	URL
API	`http://localhost:3000`
Frontend	`http://localhost:8080`
Worker	`http://localhost:3001` (inbound webhooks)
MCP server	stdio, no HTTP port. `pnpm --filter ./apps/mcp run dev:http` serves it over HTTP on port 3002.

Hot reload

All services support hot reload. Edit any file under apps/ and the relevant service restarts automatically.

Running individual services

pnpm dev:api        # API only
pnpm dev:frontend   # Frontend only
pnpm dev:worker     # Worker only
pnpm dev:mcp        # MCP server only

Stopping

# Ctrl+C to stop pnpm dev

Getting Started

Installation

Providers

Development Environment

Prerequisites

Step 1: Clone and install

Step 2: Configure environment

Step 3: Run the database schema

Step 4: Start the app

Hot reload

Running individual services

Stopping

​Prerequisites

​Step 1: Clone and install

​Step 2: Configure environment

​Step 3: Run the database schema

​Step 4: Start the app

​Hot reload

​Running individual services

​Stopping

Prerequisites

Step 1: Clone and install

Step 2: Configure environment

Step 3: Run the database schema

Step 4: Start the app

Hot reload

Running individual services

Stopping