TrueForge

项目简介

TrueForge 是开源的智能体运行框架，由运行智能体循环的核心服务器、带 TypeScript SDK 的 HTTP API，以及带 React UI SDK 的聊天界面组成。它编排自带模型提供商、MCP 服务器和沙箱服务，并处理规划、工具执行、上下文管理、审批与会话状态。支持使用 SQLite 的本地模式和采用 Postgres 与 Redis 的托管模式。

核心功能

• 支持任意模型提供商，包括 OpenAI、Anthropic、Google Gemini、其他目录提供商或任意 OpenAI 兼容端点；支持远程 MCP 服务器，可通过请求头认证或 OAuth 授权，并支持聊天内授权；技能为基于 Git 的 SKILL.md 指令包，在沙箱中按需加载；沙箱作为工具使用，仅在需要时提供隔离的代码与文件执行，密钥保留在运行框架中；提供人工检查点，包括工具审批、向用户提问以及聊天中的生成式 UI；上下文工程包括子智能体、延迟工具加载、Code Mode、大结果卸载与压缩。

适用场景

• 可在本地机器上以单进程和 SQLite 进行个人使用，类似 Claude Desktop；可用于团队或生产共享部署，使用 Postgres、Redis 和可选的 OIDC 登录；可通过 HTTP API 与 TypeScript SDK 从应用代码自动创建智能体会话并流式接收轮次；可通过 @truefoundry/trueforge-ui 在 React 应用中嵌入自定义聊天界面。

快速开始

• 本地快速体验可运行 npx @truefoundry/trueforge@latest。按照快速入门指南可在本地或使用 Docker Compose、Kubernetes 或 Railway 运行 TrueForge，然后连接模型、工具与技能，并构建第一个可复用智能体。

部署与要求

• 本地模式以单进程运行，使用 SQLite 存储，不需要额外基础设施。托管模式使用 Postgres 存储，并以 Redis 作为额外基础设施，可通过 Docker Compose、Helm 或 Railway 运行。共享部署可启用可选的 OIDC 登录，并区分管理员与普通用户角色。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。