02

Local setup

Getting started1 min read

Ports, environment contracts, databases, and focused development commands.

Local services

ServiceAddressResponsibility
Web127.0.0.1:3120Next.js app and developer UI
API BFFlocalhost:3110Auth, public API, streaming, approvals
Agent runtimelocalhost:3001Agents SDK orchestration and sessions
Tool gatewaylocalhost:3002MCP, connectors, policy, audit
Postgreslocalhost:5432Durable platform state
Redislocalhost:6379Locks, fanout, and rate limits
Local data plane
$ docker compose -f docker-compose.dev.yml up -d postgres redis$ pnpm dev:ai:local$ pnpm dev:ai:local:check

Secrets stay local

Use .env.example as the key contract. Never expose service-role keys, connector tokens, exchange credentials, or wallet material to a browser, model context, sandbox, fixture, or log.

Was this page helpful?

Edit on GitHub