Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.3ngram.ai/llms.txt

Use this file to discover all available pages before exploring further.

Self-hosting runs the open-source 3ngram core locally: MCP server, REST API, dashboard, Postgres with pgvector, Redis, migrations, and a seeded admin user. Hosted-only modules such as billing, notifications, managed integrations, and admin operations are disabled by default. The self-host core gives your agents the context they need for each kind of work: search for source-grounded results, briefing for the current state of a topic, and execution that loads the right context into your MCP client before work starts. Durable Work Contexts and managed agent loops are the direction 3ngram is heading; they are managed-paid capabilities and are not part of the self-host core today.

​
Prerequisites

  • Docker with Docker Compose v2
  • Git

​
Start the stack

git clone https://github.com/B3dmar/engram.git
cd engram
docker compose up
The first boot builds the API, MCP, and frontend images, applies migrations, and creates the local admin user.

​
Local endpoints

SurfaceURL
Dashboardhttp://localhost:3000
REST APIhttp://localhost:8000
MCP serverhttp://localhost:8001/mcp
Postgreslocalhost:5432
Redislocalhost:6379

​
Sign in

Use the seeded local account: 
Email: dev@local.test
Password: DevPassword1!
Change these with SELFHOST_SEED_EMAIL, SELFHOST_SEED_PASSWORD, and SELFHOST_SEED_NAME in your .env file before first boot.

​
Connect an MCP client

Use this MCP URL for local clients: 
http://localhost:8001/mcp
For Claude Code: 
claude mcp add --transport http --scope user 3ngram http://localhost:8001/mcp
For Codex: 
codex mcp add 3ngram --url http://localhost:8001/mcp
codex mcp login 3ngram

​
Stop or reset

Stop containers without deleting data: 
docker compose down
Delete local data volumes: 
docker compose down -v
docker compose down -v deletes the Postgres and Redis volumes for this compose project.