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…

Что это такое?TrueForge — это открытая среда для запуска агентов, то есть слой, который выполняет полный цикл работы агента (вызовы моделей, инструменты MCP, навыки, песочницу, подтверждения, управление контекстом, состояние сессии) и предоставляет его через чат-интерфейс, HTTP API с TypeScript SDK и встраиваемый UI SDK.
Это фреймворк, с которым я пишу код, или готовое к запуску приложение?И то и другое: его можно запустить как отдельный сервис (чат-интерфейс и API), чтобы сразу получить работающего агента, или построить на его основе, используя TypeScript-клиент @truefoundry/trueforge-sdk и встраиваемый @truefoundry/trueforge-ui.
Как его запустить?Выполните `npx @truefoundry/trueforge` для быстрой локальной настройки на базе SQLite в одном процессе. Для общего или продакшен-использования разверните режим хостинга с Postgres и Redis через Docker Compose, Helm или Railway.
Какие провайдеры моделей и инструменты можно подключить?TrueForge работает с OpenAI, Anthropic, Google Gemini, другими провайдерами из каталога и любой конечной точкой, совместимой с OpenAI. Он подключается к удалённым серверам MCP (с авторизацией по заголовкам или через OAuth), а также к наборам навыков SKILL.md из git-репозиториев.
Безопасно ли открывать локальный режим для доступа с других машин?Нет. В локальном режиме по умолчанию нет входа в систему, а данные хранятся в локальном файле SQLite. В проекте прямо сказано, что его нужно держать на localhost, и разработчики не отвечают за потерю данных или несанкционированный доступ, если его используют за пределами этого. Для общего или продакшен-использования лучше выбрать режим хостинга.
Какого провайдера песочницы он использует для выполнения кода?Сейчас для изолированного выполнения в песочнице используется Daytona. Песочница создаётся только тогда, когда она нужна агенту. Поддержка других провайдеров песочниц запланирована.
Чем это отличается от Claude Managed Agents или deepagents?TrueForge сравнивает себя с Claude Managed Agents и deepagents на одинаковых задачах, инструментах и модели и сообщает ту же точность при меньшей стоимости.
Что здесь означает «инжиниринг контекста»?Это встроенные техники: субагенты, отложенная загрузка инструментов, Code Mode, вынос больших результатов во внешнее хранилище и сжатие (compaction). Они помогают держать контекст агента в управляемом объёме.
Можно ли проверять или блокировать вызовы инструментов до их запуска?Да. TrueForge поддерживает проверки человеком: подтверждение инструментов, вопросы к пользователю (ask-user-questions) и запросы Generative UI в чате.
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