TrueForge 是一个开源的 agent harness，也就是把 LLM 变成可工作智能体的运行时层。它由 TrueFoundry 开发并以 MIT 许可证发布。其核心价值在于：构建一个智能体很容易，但要把它运行好却很难——你需要流式输出、会话持久化、工具服务器、沙箱、审批和 UI。TrueForge 把这些能力开箱即用地提供出来。
主要能力：
-
执行循环：TrueForge 为你运行智能体的执行循环，包括模型调用、MCP 工具、技能、沙箱、审批、上下文管理和会话状态。
-
三种暴露方式：聊天 UI、带 TypeScript SDK 的 HTTP API（@truefoundry/trueforge-sdk），以及可嵌入的 UI SDK（@truefoundry/trueforge-ui）。
-
初始设置来自目录：一次性配置模型、MCP 服务器、技能和沙箱，智能体从已连接的内容中挑选。预设来自随附的 YAML 目录，可自定义。
-
任意模型提供商：支持 OpenAI、Anthropic、Google Gemini 及其他目录提供商，或任何 OpenAI 兼容端点。
-
MCP 工具：支持带请求头认证或 OAuth 的远程 MCP 服务器，包括聊天内授权。
-
技能：基于 git 的 SKILL.md 指令包，在沙箱中按需加载。
-
沙箱即工具：隔离的代码/文件执行（目前为 Daytona，未来计划支持更多提供商），仅在需要时配置。密钥保留在 harness 中。
-
人工检查点：工具审批、向用户提问，以及聊天中的生成式 UI。
-
上下文工程：子智能体、延迟工具加载、Code Mode、大结果卸载和压缩。
-
聊天 UI + SDK：使用内置 UI，通过 @truefoundry/trueforge-sdk 自动化，或嵌入 @truefoundry/trueforge-ui。
部署方式：
TrueForge 可缩可放：本地模式（单进程 + SQLite）或托管模式（Postgres + Redis，Docker Compose、Helm 或 Railway）。
快速开始：
可使用 Quickstart 指南通过多种方式（本地、Docker Compose、Kubernetes 或 Railway）运行 TrueForge，连接模型、工具、技能并构建第一个可复用智能体。若要在本仓库中开发 TrueForge，请参阅 CONTRIBUTING.md。
限制与注意事项：
本地模式仅适用于你的机器，是试用 TrueForge 的便捷方式，而非生产或面向互联网的设置。默认没有登录，数据存于本地 SQLite 文件，请保持在 localhost 上使用。若超出此范围使用本地模式，官方不承担数据丢失或未授权访问的责任。对于共享或生产部署，请使用托管模式。
此外，TrueForge 在相同任务、工具和模型上与 Claude Managed Agents 和 deepagents 进行了基准比较，官方称具有相同准确率、更低成本，可从 benchmark/ 目录复现，相关文章为 Benchmarking。项目欢迎贡献（bug 报告、功能和文档修复），Fork PR 应只修改源码，维护者会在合并后重新生成 SDK。安全漏洞请遵循 SECURITY.md 报告，而非公开 issue。社区有 Discord。
