bubseek

Enterprise-oriented distribution of Bub for agent-driven insight workflows in cloud-edge environments.

bubseek turns fragmented data across operational systems, repositories, and agent runtime traces into explainable, actionable, and shareable insights without heavy ETL. It keeps the Bub runtime and extension model while packaging a practical default distribution for real deployments.

bubseek now boots through a single distribution entry point and targets SeekDB/OceanBase tape storage through the SQLAlchemy URL or OCEANBASE_* settings.

Features

• Lightweight and on-demand — Trigger analysis when needed instead of maintaining large offline pipelines.
• Explainability first — Conclusions are returned together with agent reasoning context.
• Cloud-edge ready — Supports distributed deployment and local execution boundaries.
• Agent observability — Treats agent behavior as governed, inspectable runtime data.
• Bub-compatible — Forwards Bub commands directly; no fork of the core runtime.

Quick start

Requires uv (recommended) or pip, and Python 3.12+.

git clone https://github.com/ob-labs/bubseek.git
cd bubseek
uv sync
uv run bubseek --help
uv run bubseek chat

If your runtime reads credentials from .env, bubseek forwards them to the Bub subprocess:

BUB_MODEL=openrouter:qwen/qwen3-coder-next
BUB_API_KEY=sk-or-v1-...
BUB_API_BASE=https://openrouter.ai/api/v1

Configure SeekDB or OceanBase before running bubseek, using BUB_TAPESTORE_SQLALCHEMY_URL=mysql+oceanbase://... or the matching OCEANBASE_* variables.

Add contrib

Contrib packages remain standard Python packages. Add them as normal dependencies. The bundled channel extras resolve from GitHub-hosted bub-contrib packages instead of local workspace packages.

[project]
dependencies = [
    "bub==0.3.0a1",
    "bub-codex @ git+https://github.com/bubbuild/bub-contrib.git@main#subdirectory=packages/bub-codex",
]

Then sync your environment:

uv sync

• Optional extras: Feishu uv sync --extra feishu, DingTalk uv sync --extra dingtalk, Marimo uv sync --extra marimo.

Documentation

Development

make install
make check
make test
make docs

See CONTRIBUTING.md for contribution guidelines.

License

Apache-2.0.