Community Edition & Cloud

Install SyntheticBrew: coding agent, Docker, or binary

Let your coding agent set everything up over MCP, or self-host the full AI agent runtime — admin dashboard, REST and SSE API, and PostgreSQL-backed state included.

Install with your coding agent (MCP) recommended

Your coding agent connects to the SyntheticBrew MCP server and provisions a ready-to-embed agent for you — no dashboard clicking.

Create a free account at /register, then run the command for your agent below. Your browser opens to sign in — there is no token to copy.

A browser opens to sign in — no token to copy.

Terminal

$ claude mcp add --transport http syntheticbrew https://app.syntheticbrew.ai/api/v1/mcp/rpc

Terminal

$ claude mcp login syntheticbrew

What happens next

Add the MCP server with the command above.
Run the login command — a browser opens; create an account or sign in and approve.
Tell your agent what you need. It provisions the agent, configures it, and hands you the embed snippet.

Total time: under 5 minutes. No config files.

Self-hosting?

Point the same command at <your-engine-url>/api/v1/mcp/rpc and pass a token header — open /admin → API Keys → “Connect a coding agent” to mint one: --header "Authorization: Bearer YOUR_TOKEN".

No account yet? Ask our docs first:

Docs-search MCP servercopy and run

claude mcp add --transport sse syntheticbrew-docs https://mcp.syntheticbrew.ai/sse

A public docs-search MCP server with one search_docs tool — no signup.

Docker Compose self-hosted

Download the verified Compose configuration, then start SyntheticBrew Engine and PostgreSQL 16. Ready in about 30 seconds.

1 · Download configurationcopy and run

curl -fsSL https://syntheticbrew.ai/releases/docker-compose.yml -o docker-compose.yml

2 · Start Engine + PostgreSQLcopy and run

docker compose up -d

Open http://localhost:8443/admin to configure your first agent. To upgrade later, run docker compose pull && docker compose up -d.

Standalone binary

Install without Docker

The engine is open source — build the binary straight from the repository. You need Go 1.25+ and an existing PostgreSQL 14 or later database.

1 · Clone the repositorycopy and run

git clone https://github.com/syntheticinc/syntheticbrew && cd syntheticbrew/engine

2 · Build the Engine binarycopy and run

go build -o syntheticbrew ./cmd/ce

After the build

Point the Engine at your database, set a model key, and start it.

3 · Set database connectioncopy and run

export DATABASE_URL="postgresql://user:pass@host:5432/syntheticbrew"

4 · Set your model keycopy and run

export LLM_API_KEY=sk-...

5 · Start the Enginecopy and run

./syntheticbrew

Then open http://localhost:8443/admin to configure your first agent. The Engine automatically creates all tables on first start — no manual SQL needed. On Windows, use Docker Compose above or build with the same Go command in PowerShell.

Enterprise Edition

Upgrade a self-hosted install to Enterprise Edition

Enterprise Edition activates on top of Community Edition with a license file — no reinstall and no separate build. Without a license, the Engine keeps running as Community Edition.

Get your license.jwt from the SyntheticBrew dashboard.
Place it at ~/.syntheticbrew/license.jwt on the host running the Engine.
Restart the Engine — licensed Enterprise Edition features are now active.

See what Enterprise Edition includes on the pricing page.

System requirements

Resource	Docker Compose	Binary
Docker	20.10+	Not needed
Go toolchain	Not needed	1.25+ (build from source)
CPU	1 core; 2+ recommended	Same
RAM	1 GB; 2 GB+ recommended	512 MB plus PostgreSQL
Disk	500 MB plus data	100 MB plus PostgreSQL data
PostgreSQL	Included	14+ required
Network	Outbound to your LLM provider	Same

Keep going with the docs

Quick start: your first agent →

Docker deployment guide · Kubernetes deployment with the Helm chart

After install

Connect SyntheticBrew to your product

Open source

SyntheticBrew community: GitHub and docs

Licensed under BSL 1.1 — free to self-host, converting to Apache 2.0 after four years.