This release is a pre-release and may not be stable for production use.
Bub
Bub is a small Python runtime for building agents in shared environments. It started in group chats, where multiple humans and agents had to work in the same conversation without hidden state, hand-wavy memory, or framework-specific magic.
Built on agents.md and Agent Skills, Bub stays intentionally small. Every turn stage is a pluggy hook, builtins are replaceable, and the same runtime drives CLI, Telegram, and any channel you add.
Quick Start
macOS and Linux:
curl -fsSL https://bub.build/install.sh | bash
Windows PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
Then:
bub chat # interactive session
bub run "summarize this repo" # one-shot task
bub gateway # channel listener mode
See Getting Started for installer presets and source installs, and Configure for model and runtime settings.
Why Bub
- Composable by design. Every turn stage is a plugin hook. Override one stage or replace the whole flow without forking the runtime.
- Tape context. Context is rebuilt from append-only records, not carried around as mutable session state. Easier to inspect, replay, and hand off.
- One runtime across surfaces. The same inbound pipeline runs across CLI, Telegram, and custom channels. Adapters change the surface, not the runtime model.
- Batteries included. CLI, Telegram, tools, skills, and model execution ship with the core runtime. Use the defaults first, replace them later.
- Operator equivalence. Humans and agents work inside the same runtime boundaries, with the same evidence trail and handoff model.
- Embeddable Python SDK.
bub.coreexposes the agent loop on its own — bring your own model, tools, prompts, and tape store, with no settings or plugins required.
How It Works
Every inbound message goes through one turn pipeline. Each stage is a hook.
resolve_session → load_state → build_prompt → run_model
↓
dispatch_outbound ← render_outbound ← save_state
Builtins are registered first and external plugins load after them, so later plugins take precedence. There are no framework-only shortcuts.
Docs
- Getting Started — install Bub and run the first turn
- Concepts — the mental model behind the runtime
- Python SDK — embed Bub's agent loop in your own application
- Build — write plugins, override hooks, ship tools and skills
- Bub Hub — browse community plugins, skills, and distributions
- Channels — run Bub in CLI, Telegram, or your own channel
- Deployment — Docker, environment, upgrades
Background
License
Metadata
Release files for bub 0.6.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bub-0.6.0a1.tar.gz | 252.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bub-0.6.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 443.9 kB
Release files / bub-0.6.0a1.tar.gz
| Download URL | bub-0.6.0a1.tar.gz |
|---|---|
| Size | 252.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5fe35143d0d1baa20147f6a523b8e115dcd27fb8334732aff6704767ee801a30
|
|
BLAKE2b-256 checksum How to use checksums |
6b9d35fbca6841179d23a74058f7751c4f54926eced9b0b05e7f94ee171c47dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.6.14
|
Release files / bub-0.6.0a1-py3-none-any.whl
| Download URL | bub-0.6.0a1-py3-none-any.whl |
|---|---|
| Size | 191.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fed06bab85a1a55aed5447b44d112d315b99c65a426da232bb3d0e326a5e274c
|
|
BLAKE2b-256 checksum How to use checksums |
4448568de3f75a760286498589e52946e71d753eb2a4ef05aeab8e7a8bdac1fe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.6.14
|
