Installation

From PyPI

pip install bub

From source

git clone https://github.com/bubbuild/bub.git
cd bub
uv sync
uv run bub chat

If you are setting up a contributor workspace rather than just running Bub from source, use make install instead. That also installs the website toolchain and prek hooks used by the repo.

Core commands

• uv run bub chat starts the interactive CLI.
• uv run bub run "summarize this repo" runs a single turn through the full pipeline.
• uv run bub gateway starts channel listener mode.