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

TrueForge – 一个开源的 LLM 代理运行时

它是什么 – TrueForge 是一个基于 TypeScript 的“代理工具包”。它负责运行语言模型驱动代理的执行循环：进行模型调用、调用工具、管理沙盒代码执行、处理审批、持久化会话状态，并透过三种接口公开所有功能：

Chat UI – 开箱即用的网页界面。
HTTP API – 带有 OpenAPI 规范的 REST 端点。
SDKs – TypeScript 客户端 (@truefoundry/trueforge-sdk) 与可嵌入的 UI 组件 (@truefoundry/trueforge-ui)。

它的设计旨在让开发者专注于 代理逻辑，而由 TrueForge 处理底层基础设施。

为什么使用它？

一站式基础设施 – 内置流式响应、会话持久化、工具服务器、沙盒、人工审批与上下文管理。
可插拔资源 – 模型 (OpenAI、Anthropic、Gemini 或任何兼容 OpenAI 的端点)、MCP 工具服务器、技能包 (基于 git 的 SKILL.md 文件) 与沙盒提供者 (目前为 Daytona) 均通过 YAML 目录进行配置。
可扩展部署 – 可通过单一进程与 SQLite 在本地运行，或在托管环境中使用 Postgres + Redis 通过 Docker-Compose、Helm 或 Railway 部署。
具成本效益 – 经基准测试显示，在消耗较少运算资源的情况下，能达到与 Claude Managed Agents 和 deepagents 相同的准确度。

快速开始 (一行指令)

npx @truefoundry/trueforge@latest

此指令会启动一个本地实例 (使用 SQLite，无需外部基础设施)。请依照屏幕提示或 quick-start guide 来连接模型、新增工具/技能并开始对话。

核心架构 (高阶)

+-------------------+      +-------------------+      +-------------------+
|   Chat UI / SDK   | <--->|   TrueForge HTTP  | <--->|   Agent loop      |
| (web or embed)    |      |   API (REST)      |      | (model calls,    |
+-------------------+      +-------------------+      |  MCP tools,      |
                                                   |  sandbox, state) |
                                                   +-------------------+

存储 – 本地模式使用 SQLite；托管模式使用 Postgres (外加 Redis 用于缓存)。
资源 – 代理循环读取 YAML 目录以发现模型、MCP 服务器、技能与沙盒提供者。
沙盒即工具 – 代码在隔离环境中执行；机密信息保留在工具包内部。
人工检查点 – 在执行工具前的选用审批步骤或“询问用户”提示。

进阶入门

模式	使用时机	执行方式
Local	个人实验、原型开发	`npx @truefoundry/trueforge` (SQLite，无需登录)
Hosted	团队协作、多副本、生产级工作负载	使用 Docker-Compose、Helm chart 或 Railway 部署；配置 Postgres + Redis

文档涵盖：

初始设置 – 配置模型、MCP 服务器、技能、沙盒的目录。
创建代理 – 选择资源、启用工具审批、新增生成式 UI。
会话与排程 – 查看过去的执行记录、设置周期性代理。
身份验证 – 用于共享部署的选用 OIDC。
基准测试 – 在 benchmark/ 中重现成本/准确度比较。

安装与生态系统

npm 包 – @truefoundry/trueforge (CLI/服务器), @truefoundry/trueforge-sdk, @truefoundry/trueforge-ui, @truefoundry/trueforge-core。
Helm chart – 发布于 tfy.jfrog.io/... 以供 Kubernetes 使用。
文档 – https://trueforge.dev (介绍、API 参考、UI 指南等)。

社区与贡献

Discord – https://discord.com/invite/fHeGRvakb
Issues / PRs – 遵循标准 GitHub 工作流程；合并后，维护者会重新生成 SDK。
安全性 – 请通过 SECURITY.md 报告。
授权 – MIT。

总结

TrueForge 为您提供了一个生产级的 LLM 代理运行时：插入任何模型、新增工具/技能，让 TrueForge 处理沙盒、审批与持久化，并透过网页 UI 或 TypeScript SDK 进行互动。它适用于本地快速测试，也能扩展至 Kubernetes 以供团队使用。

truefoundry/trueforge