KohakuTerrarium

KohakuTerrarium 是一個通用型 AI 代理框架,也是一款功能齊全的應用程式,用於建置、執行及組合獨立代理與多代理團隊。

KohakuTerrarium 是什麼?

KohakuTerrarium 是一個通用型 AI 代理框架,也是一款功能齊全的應用程式,用於建置、執行及組合獨立代理與多代理團隊,內建工具、子代理、持久化工作階段、TUI 與網頁 UI。

KohakuTerrarium 概覽

這是什麼

KohakuTerrarium 是一個通用型 AI 代理框架與內建完整功能的應用程式,用於建構、執行與組合自包含的代理及多代理團隊。它提供包含控制器迴圈、工具分派、觸發器、子代理、工作階段、持久化與多代理連線的基礎層,讓新的代理形態只需設定檔與自訂模組即可建立,無需從頭實作。核心抽象是「生物」(creature),一個擁有自己的控制器、工具、子代理、觸發器、記憶體與輸入輸出的獨立代理,由 Terrarium 引擎託管。Studio 層提供目錄、身分識別、工作階段管理以及網頁/桌面/API 介面。所有元件皆以 Python 實作,代理是可 await 的物件,並回傳型別化的結果。

主要功能

  • 代理層級抽象:六模組的生物模型是第一級概念;新的代理形態只需設定檔與可能少量的自訂模組。
  • 真正的 Python API:Agent.build、具備可取消逾時的型別化 TurnResult、串流型別化事件、@kt.tool 將任意函式轉為代理工具、直接注入 LLM 實例、預設嚴格錯誤處理。
  • 內建工作階段持久化與恢復:引擎建立並管理工作階段檔案;數小時後可透過 kt resume 或 Terrarium.resume 恢復;SessionReader 可離線重播已完成的執行。
  • 可搜尋的工作階段歷史:每個事件皆被索引;kt search 與 search_memory 工具可讓使用者與代理查詢過去的工作。
  • 非阻塞式上下文壓縮:長時間執行的代理在背景壓縮上下文時仍可繼續運作。
  • 全面的內建工具與子代理:檔案、Shell、網頁、JSON、筆記本、搜尋、編輯、規劃、審查、研究,以及特權節點上的圖形編輯工具。
  • MCP 支援:可依代理或全域連接 stdio/streamable-HTTP MCP 伺服器;四個元工具可在連接多個伺服器時保持提示詞簡潔。
  • 套件系統與市集:kt install @name 透過 TerrariumMarket 解析;kohakuterrarium.packages.ensure 是冪等的腳本端原始操作。
  • 組合代數:>>、&、|、*、.iterate 運算子可將代理串接成管線。
  • 多種執行介面:開箱即用的 CLI、TUI、網頁儀表板與原生桌面應用程式。
  • 可選的四層驗證:主機令牌、管理員密碼與多使用者帳號;每層可選擇啟用;預設為全部關閉。

使用情境

KohakuTerrarium 適用於建構新的代理形態而無需從頭重建基礎層、使用可自訂的強大開箱即用代理、從 Python 程式碼驅動代理以執行批次作業、機器人或管線,以及需求仍在演變的情境。若現有代理產品已符合穩定需求、思維模型無法對應到控制器/工具/觸發器/子代理/通道,或需要低於 50 毫秒的每次操作延遲,則較不適合。

快速開始

bashpip install kohakuterrariumkt login codexkt install @kt-biomekt run @kt-biome/creatures/swe --mode cli

授權與價格

提供的 README 與中繼資料中未說明授權條款。該專案標示為開源,定價類型為 open_source。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/kohaku-labkohakuterrarium.svg)](https://yunodb.com/tools/kohaku-labkohakuterrarium?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/kohaku-labkohakuterrarium?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/kohaku-labkohakuterrarium.svg" alt="Featured on YunoDB" height="20"></a>