bubbuild/bub

Health v2 · maintenance only

Adoption not part of the score

1592 stars · 157 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Bub is a small Python runtime for building AI agents that operate in shared environments alongside humans. It uses a hook-first architecture where every turn stage is a pluggy hook, with append-only tape records for context and channel adapters for CLI, Telegram, and custom surfaces.

Use cases

• build ai agents that collaborate with humans in group chats
• run an llm agent from the cli or telegram
• customize agent turn pipeline stages with hooks
• extend an agent runtime with custom plugins tools and skills
• replay and inspect agent conversation history from tape records
• deploy a self-hosted agent gateway listening on chat channels
• swap llm providers without changing the agent runtime

When to choose

• you want a minimal, hackable agent runtime where every pipeline stage is overridable
• you need agents and humans sharing the same conversation with transparent, inspectable state
• you want one runtime driving multiple chat surfaces like CLI and Telegram

When to avoid

• you need a batteries-heavy agent framework with a large built-in tool ecosystem
• you want a no-code or hosted agent platform rather than a Python framework
• you need mature production guarantees - the project is young with a small core

Facets

framework · maturity active

agent-framework plugin-system chatbot llm-inference cli middleware workflow-automation large-language-models chatbots developer-tools messaging-platforms python cli cross-platform self-hosted hook-first pluggy tape-context channel-agnostic agents-md agent-skills multi-agent turn-pipeline litellm ai-agents automation telegram

Member repositories

For agents

markdown · JSON · MCP: product_card(name="bubbuild/bub")