Overview
TrueForge is an open-source agent harness — the runtime layer between a model and a working agent. It runs the execution loop for you: model calls, MCP tools, skills, sandboxing, approvals, context management and session state, none of which is interesting to rebuild but all of which is required before an agent is usable.
It exposes that loop three ways: a bundled chat UI, an HTTP API with a TypeScript SDK (`@truefoundry/trueforge-sdk`), and an embeddable UI SDK (`@truefoundry/trueforge-ui`) for putting agent chat inside your own product. Configuration is catalogue-driven — you connect models, MCP servers, skills and a sandbox once from shipped YAML catalogues you can customise, and individual agents pick from what is connected.
The runtime scales in both directions. Local mode is a single process backed by SQLite, started with one npx command, and is explicitly meant for trying things out on your own machine rather than exposing to a network. Hosted mode adds Postgres and Redis and deploys via Docker Compose, Helm or Railway for teams and multi-replica setups. Context engineering features — subagents, deferred tool loading, Code Mode, large-result offloading and compaction — are built in, as are human checkpoints such as tool approval, ask-user questions and generative UI in chat.
What it does
- Runs the full agent loop: model calls, MCP tools, skills, sandboxing, approvals, context management and session state
- Three interfaces over one runtime — a chat UI, an HTTP API with a TypeScript SDK, and an embeddable UI SDK
- Any model provider: OpenAI, Anthropic, Google Gemini and other catalogue providers, or any OpenAI-compatible endpoint
- Remote MCP servers with header auth or OAuth, including in-chat authorization, plus git-backed SKILL.md instruction packs loaded on demand
- Sandbox as a tool — isolated code and file execution provisioned only when needed, with secrets kept in the harness
- Context engineering built in: subagents, deferred tool loading, Code Mode, large-result offloading and compaction
- Local mode (one process, SQLite) or hosted mode (Postgres + Redis) via Docker Compose, Helm or Railway
Getting started
TrueForge needs Node.js 22.14 or newer. A single npx command starts local mode with SQLite storage — no database or extra services to stand up first.
Run TrueForge locally
Local mode runs one process backed by a local SQLite file. It has no login by default, so keep it on localhost — use hosted mode for anything shared.
npx @truefoundry/trueforge@latestConnect models, tools and a sandbox
Configure model providers, MCP servers, skills and a sandbox once from the shipped YAML catalogues. Agents you create then pick from whatever you connected.
Automate with the SDK
The HTTP API is wrapped by a TypeScript SDK, so agents can be driven from your own code rather than the bundled chat UI.
npm install @truefoundry/trueforge-sdkEmbed the chat UI in your product
The UI SDK packages the chat surface for embedding. For a team deployment, switch to hosted mode (Postgres + Redis) via Docker Compose, Helm or Railway — see the quickstart at trueforge.dev.
npm install @truefoundry/trueforge-uiCommands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Ship an agent product without building streaming, session persistence, tool approval and a chat UI from scratch
- Give an internal team a shared agent with MCP tools and a sandbox, deployed on Kubernetes via the Helm chart
- Embed agent chat directly in your own application using the UI SDK instead of linking out to a separate tool
- Run skills and sandboxed code execution against your own model provider while keeping provider secrets inside the harness
How TrueForge compares
TrueForge alongside other open-source agent frameworks & builders tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| DeepSeek Harness | ★ 226k | DeepSeek AI's open-source agent harness (dsh), built on Cordis, where models, tools, skills, sessions, sandboxes, storage and the UI are all plugins composed through profiles. |
| AutoGPT | ★ 187k | One of the earliest autonomous agent projects, now a platform for building and running agents from reusable blocks and workflows. |
| DeerFlow | ★ 82.5k | ByteDance's open-source super agent harness built on LangGraph: skills, sub-agents, sandboxes, a filesystem and long-term memory for long-horizon research, coding and content tasks. |
| nanobot | ★ 48.2k | Lightweight self-hosted personal AI agent framework in Python, with a WebUI, terminal and chat-app channels, tools, long-term memory, MCP and scheduled automations. |
| Agno | ★ 42.2k | A fast Python framework (formerly Phidata) for building agents with memory, tools, and multimodal inputs, plus a runtime for deploying them in production. |
| LangGraph | ★ 41.8k | A library from the LangChain team for building stateful, graph-based agent workflows with explicit control over steps, memory, and human-in-the-loop checkpoints. |
| AgentGPT | ★ 36.3k | AgentGPT lets you name a custom AI, give it a goal, and watch it plan tasks, run them, and learn from the results, all from a web browser. |
| TrueForge | — | An agent harness that runs the execution loop, tools, sandbox and UI for you |