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

TrueForge – オープンソースのLLMエージェントランタイム

概要 – TrueForgeは、TypeScriptベースの「エージェントハーネス」です。言語モデル駆動型エージェントの実行ループ（モデル呼び出し、ツール実行、サンドボックス化されたコード実行の管理、承認処理、セッション状態の永続化）を制御し、以下の3つのインターフェースを通じて機能を提供します。

Chat UI – すぐに使えるWebインターフェース。
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 – Kubernetes用に tfy.jfrog.io/... で公開。
ドキュメント – https://trueforge.dev (導入、APIリファレンス、UIガイドなど)。

コミュニティと貢献

Discord – https://discord.com/invite/fHeGRvakb
Issues / PRs – 標準的なGitHubワークフローに従ってください。マージ後、メンテナーがSDKを再生成します。
セキュリティ – SECURITY.md を通じて報告してください。
ライセンス – MIT。

まとめ

TrueForgeは、LLMエージェントのための本番環境対応ランタイムを提供します。任意のモデルを接続し、ツールやスキルを追加するだけで、サンドボックス、承認、永続化をハーネスが処理します。Web UIやTypeScript SDKを通じて操作でき、ローカルでのテストからチームでのKubernetes運用まで幅広く対応可能です。

truefoundry/trueforge