Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bubbuild--bub/badge.svg)](/listings/bubbuild--bub)

HTML

<a href="/listings/bubbuild--bub"><img src="/api/listings/bubbuild--bub/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. # Bub
  2. <div align="center">
  3. <picture>
  4. <source srcset="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo-dark.png" media="(prefers-color-scheme: dark)">
  5. <img alt="Bub logo" src="https://raw.githubusercontent.com/bubbuild/bub/refs/heads/main/website/src/assets/bub-logo.png" width="200">
  6. </picture>
  7. <p><strong>Build your Bub.</strong></p>
  8. [Website](https://bub.build) · [Docs](https://bub.build/docs/getting-started/) · [Hub](https://hub.bub.build)
  9. </div>
  10. 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.
  11. ## Build your own agent
  12. Use `bub.core.Agent` to choose your model, tools, instructions, and conversation storage. The base `bub` package installs the kernel's dependencies.
  13. In a Python 3.12+ project:
  14. ```bash
  15. uv add bub
  16. ```
  17. 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.
  18. 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.
  19. ## Customize the Bub app
  20. Start a conversation, then add tools, skills, plugins, or channels for the work you want Bub to do.
  21. Install on macOS or Linux:
  22. ```bash
  23. curl -fsSL https://bub.build/install.sh | bash
  24. ```
  25. On Windows:
  26. ```powershell
  27. powershell -ExecutionPolicy ByPass -c "irm https://bub.build/install.ps1 | iex"
  28. ```
  29. Follow the prompts to choose plugins and configure your model, then start a conversation:
  30. ```bash
  31. bub chat
  32. ```
  33. [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).
  34. ## Documentation
  35. - [Choose a starting point](https://bub.build/docs/getting-started/)
  36. - [Shared concepts and capabilities](https://bub.build/docs/concepts/agent/)
  37. - [API and application reference](https://bub.build/docs/reference/python-api/)
  38. ## Background
  39. - [Why We Rewrote Bub](https://bub.build/posts/why-rewrite-bub/)
  40. - [Socialized Evaluation and Agent Partnership](https://bub.build/posts/socialized-evaluation/)
  41. - [Context from Tape](https://tape.systems)
  42. ## License
  43. [Apache-2.0](https://github.com/bubbuild/bub/blob/main/LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.