# Bub

> Bub is a self-hosted, open-source agent runtime for developers to build and customize AI agents with a plugin system, tape-based context, and channel-agnostic design.

- **Category:** AI Agents
- **Licence:** Apache-2.0
- **Latest version:** 0.5.1
- **Open source:** oss
- **Languages:** Python
- **Platforms:** Docker, Docker Compose, Python, Windows, macOS, pip
- **Tags:** CLI, Mcp, Telegram, Ai Agents, Plugins, LLM, Python, Self Hosted, Context Engineering, Agent runtime, Harness, Agent skills, Agent framework, Tape

## Description

Bub is a Python-based agent runtime that lets developers build custom AI agents or use the included Bub application. It uses a pluggy-based plugin system where every turn stage is a hook that can be overridden. Context is managed through an append-only tape model rather than session state, making history auditable and forkable. The same pipeline drives CLI, Telegram, and custom channels. Bub can be installed via a shell script, uv tool, or Docker, and requires Python 3.12+. It integrates with MCP servers, local llama.cpp models, and various LLM providers through the Republic library. The project is in alpha (0.6.0a3) with Apache-2.0 license.

## Links

- [Homepage](https://github.com/bubbuild/bub)
- [Website](https://bub.build/)
- [Docker](ghcr.io/bubbuild/bub)
- [Documentation](https://bub.build/docs/getting-started/)
- [GitHub](https://github.com/bubbuild/bub)
- [Plugin Hub](https://hub.bub.build)

---
Source: https://selfhost.directory/project/bub