bub
Bub it. Build it. A tiny agent runtime, composable with plugins.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bubbuild/bub with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bubbuild/bub'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/bubbuild--bub)HTML
<a href="/listings/bubbuild--bub"><img src="/api/listings/bubbuild--bub/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 70 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Bub
- <div align="center">
- <picture>
- <source srcset="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo-dark.png" media="(prefers-color-scheme: dark)">
- <img alt="Bub logo" src="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo.png" width="200">
- </picture>
- <p><strong>Build your Bub.</strong></p>
- [Website](https://bub.build) · [Docs](https://bub.build/docs/getting-started/) · [Hub](https://hub.bub.build)
- </div>
- 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:
- ```bash
- uv add bub
- ```
- Run your first agent with the [SDK guide](https://bub.build/docs/sdk/), then [serve it with FastAPI](https://bub.build/docs/sdk/web-service/) 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](https://bub.build/docs/integrations/reuse-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:
- ```bash
- curl -fsSL https://bub.build/install.sh | bash
- ```
- On Windows:
- ```powershell
- 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:
- ```bash
- bub chat
- ```
- [Run your first conversation](https://bub.build/docs/getting-started/quickstart/#cli) walks through a task in your workspace. To customize the Bub app, see [tools](https://bub.build/docs/app/tools/), [plugins](https://bub.build/docs/app/plugins/), and [packaging](https://bub.build/docs/app/distribution/). For `uv tool install` and other setup options, see [Install Bub](https://bub.build/docs/getting-started/install/#app-install).
- ## Documentation
- - [Choose a starting point](https://bub.build/docs/getting-started/)
- - [Shared concepts and capabilities](https://bub.build/docs/concepts/agent/)
- - [API and application reference](https://bub.build/docs/reference/python-api/)
- ## Background
- - [Why We Rewrote Bub](https://bub.build/posts/why-rewrite-bub/)
- - [Socialized Evaluation and Agent Partnership](https://bub.build/posts/socialized-evaluation/)
- - [Context from Tape](https://tape.systems)
- ## License
- [Apache-2.0](https://github.com/bubbuild/bub/blob/main/LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.