bubbuild/bub

Bub it. Build it. A hook-first runtime for agents that live alongside people.

What it solves

Bub 是一個 Python 執行環境,專為在共享環境(例如群組聊天)中構建 AI 代理而設計,在這些環境中,人類與代理必須在沒有隱藏狀態或複雜框架特定魔法的情況下協作。它提供了一致的方式在不同介面(CLI、Telegram 與自訂通道)上執行代理,同時保留透明且可稽核的互動歷史。

How it works

Bub 採用「hook‑first」架構,代理回合的每個階段——從會話解析、狀態載入到模型執行與外發訊息渲染——皆為可插拔的 Hook。這讓開發者能在不 Fork 執行環境的前提下,覆寫特定邏輯階段。Bub 不使用可變的會話狀態,而是採用「tape context」:上下文由僅追加的記錄重建,以確保互動更易於檢查與重放。

Who it’s for

此執行環境適合開發需要透過插件高度擴充,且必須在多個通訊渠道上運作的協作型 AI 代理。

Highlights

  • Hook-based extensibility: 每個回合階段都是 pluggy Hook,讓替換或修改執行流程變得簡單。
  • Tape context: 使用僅追加的記錄作為上下文,而非可變狀態,提升稽核與重放能力。
  • Unified runtime: 同一套 inbound pipeline 可於 CLI、Telegram 與自訂通道共用。
  • Operator equivalence: 在相同的執行環境邊界與證據軌跡中,將人類與代理視為平等。
  • Batteries included: 內建工具、技能與模型執行功能。