Development
Prerequisites
Tools and versions required to run the monorepo locally.
Required tools
| Tool | Version | Notes |
|---|---|---|
| Node.js | >= 22 | Enforced by the root package.json engines field. |
| pnpm | 11.3.0 | The repo pins this via packageManager. Run corepack enable and pnpm picks up the right version automatically. |
| Docker | any recent | Runs the local PostgreSQL (with pgvector) and MinIO (S3-compatible storage) from docker-compose.yml. |
Why Docker
Local development relies on two containerized services defined in docker-compose.yml at the repo
root:
- PostgreSQL with the
pgvectorextension, on host port6432(mapped to the container's5432). Port6432is used because5432falls inside a Windows reserved port range on some machines. - MinIO, an S3-compatible object store, on host ports
9000(S3 API) and9001(web console). Uploaded knowledge and policy documents are stored here during local development.
You don't need a managed Postgres or a real S3 bucket to develop locally. The Docker services cover both. Cloud credentials are only needed for deployed environments.
Optional: a local LLM
The platform calls hosted models through OpenRouter by default. If you want to develop fully offline,
you can point embedding and chat at a local Ollama instance instead. See the
OLLAMA_* variables in Environment variables. This path is
development-only and is disabled when NODE_ENV=production.