OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Agent Frameworks

Bub

Bub is a small Python runtime for building AI agents in shared environments. Its inbound message pipeline is organized as pluggy hooks, with built-in stages that developers can replace or extend. The same runtime supports CLI and Telegram, with adapters for additional channels.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Bub — OpenViST project profile in Agent Frameworks.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Bub when you are developing an agent and want one hook-based Python runtime for shared conversations, CLI sessions and Telegram, with replaceable turn stages.

Who it is for

  • Python developers building agents for shared group conversations.
  • Teams seeking a common agent runtime for terminal and Telegram interactions.
  • Agent developers who want to customize turn stages through plugins.

Documented uses

  • Create an interactive CLI agent or run a one-shot task.
  • Listen for messages through Telegram or another channel adapter.
  • Customize prompt construction, model execution or other turn stages with plugins.
  • Develop agents using the agents.md and Agent Skills conventions.
Before you choose

Requirements & limits

Bub is an open-source project under the Apache-2.0 license. The README documents installation on macOS, Linux and Windows PowerShell, plus setup from source.

  • The runtime uses pluggy hooks for each turn stage; later-loaded external plugins take precedence over built-ins.
  • Context is rebuilt from append-only records rather than maintained as mutable session state.
  • The same runtime model supports CLI and Telegram, with custom channels added through adapters.
  • Model settings include a documented default model identifier and environment variables for provider credentials, custom endpoints and call limits.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Install Bub from source

Set up the project from its repository so Bub can be run from source.

Before you start

  • Git
  • uv

Steps

  1. Clone https://github.com/bubbuild/bub.git.

  2. Change into the bub directory.

  3. Run the command below.

    Documented command
    uv sync

Expected outcome

The README says `uv sync` is enough to run Bub from source.

Guide limitations

  • The README recommends make install instead for local development that also needs the website toolchain and prek hooks.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
11 October 2026
Original website title
bubbuild/bub · Official homepage title · retained in its source language
How we review sourcesSuggest a correction