Configuration¶

Philosophy¶

bubseek explores a different approach: instead of scheduling BI tickets, tell the agent what you want and get insights back. All agent interactions are stored as tapes in seekdb, creating a feedback loop where the agent can analyze its own footprint.

Environment variables¶

Model (required)¶

See Getting started for model configuration.

Database (required for tape storage)¶

See Getting started for database configuration.

Channels¶

Feishu¶

Visit https://open.feishu.cn/app → Create or select app
Go to "Credentials & Basic Info" → Get App ID and App Secret
Configure event subscriptions and permissions as needed

export BUB_FEISHU_APP_ID=cli_xxx
export BUB_FEISHU_APP_SECRET=xxx
uv run bub gateway --enable-channel feishu

DingTalk¶

Visit https://open-dev.dingtalk.com/ → Create or select app
Go to app details → Get Client ID and Client Secret

export BUB_DINGTALK_CLIENT_ID=xxx
export BUB_DINGTALK_CLIENT_SECRET=xxx
uv run bub gateway --enable-channel dingtalk

Discord¶

Visit https://discord.com/developers/applications → New Application
Go to "Bot" → Add Bot
Click "Reset Token" to get bot token
Enable "Message Content Intent" in Bot settings

export BUB_DISCORD_TOKEN=your-bot-token
uv run bub gateway --enable-channel discord

Telegram¶

Open Telegram, search @BotFather
Send /newbot and follow instructions
BotFather returns the token

export BUB_TELEGRAM_TOKEN=your-bot-token
uv run bub gateway --enable-channel telegram

WeChat¶

Interactive login required:

uv run bub login wechat    # Scan QR code with WeChat app
uv run bub gateway --enable-channel wechat

Marimo (web dashboard)¶

export BUB_MARIMO_HOST=127.0.0.1  # optional
export BUB_MARIMO_PORT=2718       # optional
uv run bub gateway --enable-channel marimo

Visit http://127.0.0.1:2718 after enabling.

Other settings¶

Variable	Description
`BUB_HOME`	Data directory (default: `~/.bub`)
`BUB_MAX_STEPS`	Max steps per conversation
`BUB_MAX_TOKENS`	Max tokens per response
`BUB_SEARCH_OLLAMA_API_KEY`	For web search tool
`BUB_WORKSPACE_PATH`	Workspace directory

Add contrib packages¶

Treat contrib as ordinary Python packages:

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

Then run uv sync.

Builtin skills¶

Skills are packaged in the wheel. No extra sync step needed.

github-repo-cards — generate repo summary cards
web-search — search the web
schedule — cron-style task scheduling
friendly-python, piglet — from PsiACE/skills
plugin-creator — from bub-contrib

Marimo dashboard¶

Run uv run bub gateway --enable-channel marimo, then visit http://127.0.0.1:2718

Notebooks are generated to insights/ at runtime. The dashboard shows agent's own footprint — tapes, sessions, task history — enabling the agent to analyze itself.