Make Your AI Tools Understand Your Project
Synth is a licensed, self-hosted knowledge base for AI agents. Deploy it with the official Docker image or Helm chart, add docs, repos, PDFs, or URLs once, then Claude, OpenCode, Explore, and scripts can search that project memory with citations.
The first habit is simple: brief your AI agent before it works.
Your repo/docs/PDFs
-> Synth project memory
-> deterministic Explore + MCP tools
-> AI agents that know what to read first
Start Here
| Goal | Read |
|---|---|
| Start a licensed deployment | Quick Start |
| Install with Docker or Helm | Installation |
Install the synth command | Install the Synth CLI |
| Connect the CLI through Cloudflare Access or another gateway | CLI Access Gateways |
| Find the right screen in the web app | Web App |
| Add docs, files, URLs, or repos | Add Knowledge |
| Move project knowledge with OKF | OKF-Native Knowledge Bundles |
| Connect Claude or OpenCode | MCP for AI Agents |
| Automate retrieval from CI or a shell | CLI Automation and CI/CD |
| Use Synth from code | API & SDK |
| Deploy it for a team | Kubernetes |
The Official Deployment Shape
Synth customers run the product from licensed deployment artifacts:
Licensed Synth package
-> official Docker image or official Helm chart
-> persistent /var/lib/synth data
-> browser setup, project memory, MCP tools
For a single-VM proof of concept, use the delivered Docker Compose kit. For a team or production-style install, use the official private Helm chart with Kubernetes Secrets and persistent storage.
After the app is running, open the Synth URL, create the first admin user, add an LLM provider, create a project, ingest a source, then ask:
What should an AI agent read before changing authentication?
What Synth Gives You
- Project-scoped memory: one knowledge base per repo, service, product, or research area.
- Exact evidence: every result retains its source page, revision, excerpt, and locator.
- MCP tools: agents can call
synth_list_projects,synth_search,synth_get_page, andsynth_status. - Fresh knowledge: watchers can keep repos, Jira scopes, and Slack channels synced.
- Self-hosted control: your sources, keys, users, and projects stay on your infrastructure.
Best First Workflow
- Start Synth from the official Docker or Helm package.
- Add your project docs or repo.
- Search in Explore and inspect an exact page read.
- Create an MCP API key.
- Tell your coding agent: "Use Synth to brief this task before editing."