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…

What is this?TrueForge is an open-source agent harness - the runtime layer that runs the full agent execution loop (model calls, MCP tools, skills, sandboxing, approvals, context management, session state) and exposes it via a chat UI, an HTTP API with a TypeScript SDK, and an embeddable UI SDK.
Is this a framework I code against, or a ready-to-run app?It's both: run it as a standalone service (chat UI + API) to get a working agent immediately, or build on top of it using the @truefoundry/trueforge-sdk TypeScript client and the embeddable @truefoundry/trueforge-ui.
How do I get it running?Run `npx @truefoundry/trueforge` for a quick local setup backed by SQLite in a single process. For shared or production use, deploy hosted mode with Postgres + Redis via Docker Compose, Helm, or Railway.
Which model providers and tools can I connect?TrueForge works with OpenAI, Anthropic, Google Gemini, other catalog providers, or any OpenAI-compatible endpoint, and connects to remote MCP servers (with header auth or OAuth) plus git-backed SKILL.md skill packs.
Is local mode safe to expose beyond my own machine?No - local mode has no login by default and stores data in a local SQLite file; the project explicitly says to keep it on localhost and disclaims responsibility for data loss or unauthorized access if used beyond that. For shared or production deployments, use hosted mode instead.
What sandbox provider does it use for code execution?It currently uses Daytona for isolated sandbox execution, provisioned only when an agent needs it; more sandbox providers are planned.
How does it compare to Claude Managed Agents or deepagents?TrueForge benchmarks itself against Claude Managed Agents and deepagents on the same tasks, tools, and model, reporting the same accuracy at lower cost.
What does context engineering mean here?It refers to built-in techniques like subagents, deferred tool loading, Code Mode, large-result offloading, and compaction, used to keep agent context manageable.
Can I review or block tool calls before they run?Yes - TrueForge supports human checkpoints such as tool approval, ask-user-questions, and Generative UI prompts in chat.
What are similar projects?ruflo, turnstone, evenfire, LibreChat, goclaw, sim, open-swe, hive
Size
46.3 MB
Stars
6.3K
Age
2mo
Commits · 90 Days