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: 附带内置工具、技能和模型执行能力。