TrueForge：开源 Agent Harness 运行时层

开源 Agent Harness——将 LLM 转化为可工作的 Agent 的运行时层

TrueForge 为你运行 Agent 执行循环——模型调用、MCP 工具、技能、沙箱、审批、上下文管理和会话状态——并以三种方式提供：一个聊天 UI、带有 TypeScript SDK 的 HTTP API，以及可嵌入的 UI SDK。

构建一个 Agent 很容易，但要把它运行好并不容易——你需要流式输出、会话持久化、工具服务器、沙箱、审批机制和 UI。TrueForge 开箱即提供以下能力：

• 从目录进行初始设置——一次性配置模型、MCP 服务器、技能和沙箱；Agent 可从你已连接的资源中进行选择。预设来自随项目提供、且可自定义的 YAML 目录。
• 任意模型提供商——支持 OpenAI、Anthropic、Google Gemini 和目录中的其他提供商，也支持任意 OpenAI 兼容端点。
• MCP 工具——支持采用请求头认证或 OAuth 的远程 MCP 服务器，包括聊天内授权。
• 技能——由 git 驱动的 SKILL.md 指令包，按需加载到沙箱中。
• 作为工具的沙箱——隔离的代码／文件执行环境（当前为 Daytona；计划支持更多提供商），仅在需要时创建。密钥始终保留在 Harness 内。
• 人工检查点——支持工具审批、向用户提问，以及聊天中的生成式 UI。
• 上下文工程——包括子 Agent、延迟工具加载、Code Mode、大型结果卸载和上下文压缩。
• 聊天 UI + SDK——可使用内置 UI，通过 @truefoundry/trueforge-sdk 自动化，或嵌入 @truefoundry/trueforge-ui。

它既可小规模运行，也可横向扩展：支持本地模式（单进程、SQLite）和托管模式（Postgres + Redis、Docker Compose 或 Helm）。

运行 TrueForge（本地、Docker Compose 或 Kubernetes），连接模型和工具，并通过快速开始构建第一个可复用 Agent。

如需在此代码仓库中参与 TrueForge 开发，请参阅 CONTRIBUTING.md。

**本地模式仅供你的本机使用。**它是试用 TrueForge 的便捷方式，并非生产环境或面向互联网的部署方案。默认没有登录机制，数据保存在本地 SQLite 文件中。请仅在 localhost 上使用它。若将本地模式用于除此之外的场景，我们无法对数据丢失或未授权访问承担责任。如需共享部署或生产部署，请使用托管模式。

我们在相同任务、工具和模型条件下，将 TrueForge 与 Claude Managed Agents 和 deepagents 进行比较：准确率相同，成本更低。可通过 benchmark/ 复现。详见：基准测试。

我们欢迎贡献——Bug 报告、功能建议和文档修复。请参阅 CONTRIBUTING.md 和我们的行为准则。Fork 提交的 PR 应仅修改源代码；维护者会在合并后重新生成 SDK。

如需报告安全漏洞，请遵循 SECURITY.md，而不要创建公开 Issue。

TrueForge 依据 MIT License 发布。

The open-source agent harness - the runtime layer that turns an LLM into a working agent

TrueForge runs the agent execution loop for you - model calls, MCP tools, skills, sandboxing, approvals, context management, and session state - and exposes it three ways: a chat UI , an HTTP API with a TypeScript SDK , and an embeddable UI SDK.

Building an agent is easy. Running one well is not - you need streaming, session persistence, tool servers, sandboxing, approvals, and a UI. TrueForge gives you that out of the box:

• Initial setup from catalogs - configure models, MCP servers, skills, and a sandbox once; agents pick from what you connected. Presets come from shipped YAML catalogs you can customize.
• Any model provider - OpenAI, Anthropic, Google Gemini, and other catalog providers, or any OpenAI-compatible endpoint.
• MCP tools - remote MCP servers with header auth or OAuth, including in-chat authorization.
• Skills - git-backed SKILL.md instruction packs, loaded on demand in the sandbox.
• Sandbox as a tool - isolated code/file execution (Daytona today; more providers planned), provisioned only when needed. Secrets stay in the harness.
• Human checkpoints - tool approval, ask-user-questions, and Generative UI in chat.
• Context engineering - subagents, deferred tool loading, Code Mode, large-result offloading, and compaction.
• Chat UI + SDK - use the bundled UI, automate with @truefoundry/trueforge-sdk, or embed @truefoundry/trueforge-ui.

It scales down and up: local mode (one process, SQLite) or hosted mode (Postgres + Redis, Docker Compose or Helm).

Run TrueForge (local, Docker Compose, or Kubernetes), connect a model and tools, and build your first reusable agent in the Quickstart.

To work on TrueForge from this repository, see CONTRIBUTING.md.

Local mode is for your machine only. It is a convenient way to try TrueForge — not a production or internet-facing setup. There is no login by default, and data lives in a local SQLite file. Please keep it on localhost. We cannot take responsibility for data loss or unauthorized access if local mode is used beyond that. For a shared or production deployment, use hosted mode.

We compare TrueForge against Claude Managed Agents and deepagents on the same tasks, tools, and model - same accuracy, lower cost. Reproduce it from benchmark/. Write-up: Benchmarking.

We love contributions - bug reports, features, and docs fixes. See CONTRIBUTING.md and our Code of Conduct. Fork PRs should change source only; maintainers regenerate the SDK after merge.

To report a security vulnerability, follow SECURITY.md instead of opening a public issue.

TrueForge is released under the MIT License.