Skip to main content

Bub

Bub logo

Build your Bub.

Website · Docs · Hub

Put an agent in your own Python program, or customize the Bub application. The application uses the same agent kernel and adds configuration, plugins, and channel integration.

Build your own agent

Use bub.core.Agent to choose your model, tools, instructions, and conversation storage. The base bub package installs the kernel's dependencies.

In a Python 3.12+ project:

uv add bub

Run your first agent with the SDK guide, then serve it with FastAPI when you need an HTTP endpoint.

You can also embed BubAgent to reuse the application's settings and plugin hooks in your service. This uses bub[app]; Reuse the Bub app explains the integration choices and their requirements.

Customize the Bub app

Start a conversation, then add tools, skills, plugins, or channels for the work you want Bub to do.

Install on macOS or Linux:

curl -fsSL https://bub.build/install.sh | bash

On Windows:

powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"

Follow the prompts to choose plugins and configure your model, then start a conversation:

bub chat

Run your first conversation walks through a task in your workspace. To customize the Bub app, see tools, plugins, and packaging. For uv tool install and other setup options, see Install Bub.

Documentation

Background

License

Apache-2.0

Metadata

Release files for bub 0.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bub 0.6.1
File Size Uploaded Provenance Actions
bub-0.6.1.tar.gz 290.0 kB With provenance Details for bub-0.6.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bub 0.6.1
File Interpreter ABI Platform Actions
bub-0.6.1-py3-none-any.whl Python 3 none any Details for bub-0.6.1-py3-none-any.whl

Total release size: 507.3 kB

Release files / bub-0.6.1.tar.gz

Download URL bub-0.6.1.tar.gz
Size 290.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f64d410564ddeeb5d65c6c6dfa4eb255a4cceb4c7d22ce0bb4852c42c4ba6359
BLAKE2b-256 checksum
How to use checksums
dc17785546ff2ffb8d3fc54ee1d526d909a92616a3192b0ce74116e7e8220263
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Release files / bub-0.6.1-py3-none-any.whl

Download URL bub-0.6.1-py3-none-any.whl
Size 217.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3a4d56281cf9d3125ff25060aed1374c15a93bf624c36cc52175e1c40c89d88c
BLAKE2b-256 checksum
How to use checksums
2f3c39be7c0b0023977208aeba3e98fedb5403297df84d29cc6a361bf3af946b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Security for bub 0.6.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for bub-0.6.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.6.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page