Kohaku-Lab/KohakuTerrarium

解決する問題

多くの既存のエージェント製品（Claude Code、Codex など）は、それぞれ同じ基盤メカニズム（コントローラーループ、ツールディスパッチ、トリガー、サブエージェント、セッション、永続化、マルチエージェント配線）を再実装しています。KohakuTerrarium は、その共有基盤を一箇所にまとめるため、新しいエージェントの形を作成することは、新しいコードベース全体ではなく、設定ファイルといくつかのカスタムモジュールになります。

仕組み

KohakuTerrarium は Python フレームワークです。中核となる抽象化は「クリーチャー」です。これは、独自のコントローラー（推論ループ）、ツール、トリガー、サブエージェント、メモリ、および入出力を持つ独立したエージェントです。クリーチャーは、クリーチャーのグラフ、チャネル、ライフサイクル、およびセッション管理を管理する「Terrarium」エンジンによってホストされます。その上に、「Studio」レイヤーが管理、ID、およびユーザー向けサーフェス（Web ダッシュボード、デスクトップアプリ、HTTP API）を処理します。オプションで、「Laboratory」レイヤーは WebSocket を介してホストとエンジンをマシン間で分割します。エージェントは型付き結果を持つ非同期 Python オブジェクトであるため、独自のプログラムに直接埋め込むことができます。エージェントは CLI、TUI、Web、またはデスクトップで実行でき、>>（シーケンス）、&（並列）、|（フォールバック）、*（リトライ）などの演算子を使用してパイプラインに構成できます。

対象読者

これは、車輪の再発明をせずにカスタム AI エージェントを構築したい開発者向けです。単一のエージェント、マルチエージェントチーム、またはバッチジョブ、ボット、パイプラインなどの大規模な Python アプリケーションに埋め込まれたエージェントが必要な場合でも対応します。また、カスタマイズ可能な強力なすぐに使えるエージェントを求める人にも適しています。すでにニーズに合った安定したエージェント製品がある場合、または操作ごとに 50 ミリ秒未満のレイテンシが必要な場合は、適さない可能性があります。

ハイライト

• エージェントレベルの抽象化: ランタイムを再構築するのではなく、設定とカスタムモジュールを作成して新しいエージェントを定義します。
• 本格的な Python API: 実際にキャンセルされるタイムアウト付きの型付き TurnResult ターン、ストリーミング型付きイベント、任意の関数をエージェントツールに変換する @kt.tool、および厳密なエラー処理。
• 組み込みのセッション永続化と再開: セッションは自動的に保存されます。後で kt resume または Terrarium.resume で再開します。SessionReader は、完了した実行をオフラインで再生します。
• 検索可能なセッション履歴: すべてのイベントがインデックス化されます。kt search と search_memory ツールを使用すると、あなた（およびエージェント）が過去の作業を検索できます。
• 非ブロッキングコンテキスト圧縮: 長時間実行されるエージェントは、バックグラウンドでコンテキストが圧縮されている間も動作し続けます。
• 包括的な組み込みツールとサブエージェント: ファイル、シェル、Web、JSON、ノートブック、検索、編集、および特権ノード用のグラフエディターツール。
• コンテキストを認識したサイド会話: オプションの fork ヘルパーを使用すると、メインタスクに影響を与えずに、分離されたスナップショットでサイド質問をできます。
• MCP サポート: エージェントごとまたはグローバルに MCP サーバー（stdio または streamable-HTTP）に接続します。4 つのメタツールにより、サーバーが多くてもプロンプトを小さく保ちます。
• パッケージシステムとマーケットプレイス: kt install @name は TerrariumMarket を介して解決されます。冪等なスクリプト側プリミティブが利用可能です。
• 構成代数: >>、&、|、*、および .iterate 演算子を使用してエージェントパイプラインを構築します。
• 複数のランタイムサーフェス: CLI、TUI、Web ダッシュボード、およびネイティブデスクトップアプリがすぐに含まれています。
• オプションの 4 層認証（ホストトークン、管理者パスワード、マルチユーザーアカウント）— レイヤーごとにオプトイン、デフォルトでオフ。