bub

Bub 是刻意做小的 Python 智能体运行时，基于 agents.md 和 Agent Skills 格式。它的核心理念是：回合的每个阶段——从 resolve_session、load_state 到 build_prompt、run_model，再到 render_outbound、dispatch_outbound——都是一个 pluggy 钩子。内置钩子先注册，外部插件后加载，因此你可以只覆盖一个阶段、也可以替换整个流程，而无需 fork 运行时。

它起源于群聊——多个人和智能体共享一个对话，因此刻意避免隐藏的会话状态：上下文从只追加的 tape 记录重建，可检查、可回放。同一条入站流水线同时服务 CLI、Telegram 和你自己添加的任意频道，适配器只改变表层。

安装是一行脚本（或从源码 uv sync），CLI 覆盖交互对话、单次运行和网关监听模式。配置用环境变量（模型、API key、步数与 token 上限、溢出阈值）。核心自带 CLI、Telegram、工具、技能和模型执行，且都可替换。许可为 Apache-2.0。