trueforge README

The project's README from github.com/truefoundry/trueforge. As one markdown file: README.md.

TrueForge logo

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

truefoundry%2Ftrueforge | Trendshift

License: MIT Node.js >= 22.14 Documentation Quickstart SDK

npm @truefoundry/trueforge npm @truefoundry/trueforge-sdk npm @truefoundry/trueforge-ui npm @truefoundry/trueforge-core helm trueforge Ask DeepWiki

TrueForge

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.

TrueForge Chat UI

Why TrueForge?

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:

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

Getting started

Quickstart with npx

npx @truefoundry/trueforge@latest

Use the Quickstart guide to run TrueForge using various methods (Local, Docker Compose, Kubernetes, or Railway). Connect models, tools, skills and build your first reusable agent.

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

Architecture

TrueForge architecture: Chat UI and SDK connect to the TrueForge server HTTP API and agent loop, which talks to SQLite or Postgres and bring-your-own models, MCP servers, and sandbox

Mode Best for Storage Extra infra How to run
Local Personal use, trying it out SQLite None npx @truefoundry/trueforge
Hosted Teams, multi-replica Postgres Postgres + Redis Docker Compose, Helm, or Railway

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.

Documentation

Section What you'll find
Introduction What an agent harness is and how TrueForge fits together
Quickstart Run local or hosted, build your first agent
Initial Setup Models, MCP, skills, sandbox - catalogs and overrides
Create an Agent Select resources; tool approval, questions, Generative UI
Harness Capabilities Sandbox-as-tool, subagents, deferred tools, Code Mode, compaction
Setup Login Optional OIDC for shared deployments
Benchmarking Cost/accuracy vs Claude Managed Agents and deepagents
SDK TypeScript client: sessions, turns, events
Chat UI Bundled UI and embedding @truefoundry/trueforge-ui
API Reference OpenAPI paths and schemas

Benchmarks

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.

Contributing

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.

Talk to us

License

TrueForge is released under the MIT License.

trueforge (truefoundry/trueforge)

Searching Database…

6.3K ·GitHub
Trueforge
这是什么？TrueForge 是一个开源的智能体运行框架，也就是负责运行完整智能体执行循环的运行时层。这个循环包括模型调用、MCP 工具、技能、沙箱隔离、审批、上下文管理和会话状态。它通过聊天界面、带 TypeScript SDK 的 HTTP API，以及可嵌入的 UI SDK 对外提供能力。
这是我需要基于它写代码的框架，还是开箱即用的应用？两者兼有。你可以把它作为独立服务运行（聊天界面 + API），立即获得一个可用的智能体；也可以使用 TypeScript 客户端 @truefoundry/trueforge-sdk 和可嵌入的 @truefoundry/trueforge-ui 在其基础上进行二次开发。
我该如何让它跑起来？运行 `npx @truefoundry/trueforge` 即可快速完成本地部署，数据存储在单进程中的 SQLite 里。如果需要共享使用或用于生产环境，请通过 Docker Compose、Helm 或 Railway 部署托管模式，并搭配 Postgres 和 Redis。
我可以接入哪些模型提供商和工具？TrueForge 支持 OpenAI、Anthropic、Google Gemini、其他已收录的提供商，以及任何兼容 OpenAI 的接口。它还可以连接远程 MCP 服务器（支持请求头认证或 OAuth），以及基于 git 管理的 SKILL.md 技能包。
把本地模式开放到自己电脑之外，安全吗？不安全。本地模式默认没有登录功能，数据保存在本地的 SQLite 文件中。项目明确要求将其限制在 localhost 上运行；如果超出这一范围使用，项目方不对由此导致的数据丢失或未经授权的访问承担责任。如需共享或用于生产环境，请改用托管模式。
它用哪个沙箱服务商来执行代码？目前使用 Daytona 进行隔离的沙箱执行，且只有在智能体需要时才会创建。后续计划支持更多沙箱服务商。
它与 Claude Managed Agents 或 deepagents 相比如何？TrueForge 在相同的任务、工具和模型条件下，与 Claude Managed Agents 和 deepagents 进行了基准测试，结果显示其准确率相同，但成本更低。
这里所说的上下文工程是什么意思？指一系列内置技术，如子智能体、延迟加载工具、Code Mode、大结果卸载和上下文压缩，用于让智能体的上下文保持可控。
我能在工具调用执行前进行审核或拦截吗？可以。TrueForge 支持人工检查点，例如工具审批、向用户提问，以及聊天中的生成式 UI 提示。
What are similar projects?ruflo, turnstone, evenfire, LibreChat, goclaw, sim, open-swe, hive
Which topics is it in?npx, helm, harness-engineering, context-engineering, harness, oauth, sandbox, redis, model-context-protocol, orchestration, agent-orchestration, chatbot
Creator
truefoundry
Size
46.3 MB
Stars
6.3K
Updated
CommitOct 16Release@truefoundry/[email protected]Oct 16
Age
2mo
Commits · 90 Days