bub/env.example at main · bubbuild/bub · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# Bub environment example
# Copy to `.env` and fill values.

# ---------------------------------------------------------------------------
# Model / provider
# ---------------------------------------------------------------------------
# Republic model format: provider:model_id
# Default in code is `openrouter:qwen/qwen3-coder-next`.
BUB_MODEL=openrouter:qwen/qwen3-coder-next

# ---------------------------------------------------------------------------
# API keys (choose one)
# ---------------------------------------------------------------------------
# Bub reads keys in this order:
# 1) BUB_API_KEY
# 2) LLM_API_KEY
# 3) OPENROUTER_API_KEY

# Preferred explicit key
# BUB_API_KEY=sk-...

# Generic key (commonly used in this repo)
LLM_API_KEY=sk-...

# OpenRouter-specific key
# OPENROUTER_API_KEY=sk-or-...

# Optional custom API base
# BUB_API_BASE=https://openrouter.ai/api/v1

# ---------------------------------------------------------------------------
# Optional Ollama web tools override
# ---------------------------------------------------------------------------
# If BUB_OLLAMA_API_KEY is set, Bub reloads:
# - web.search -> Ollama /web_search API
# - web.fetch  -> remains markdown-style fetcher (same output contract)
#
# BUB_OLLAMA_API_KEY=ollama_...
# Optional (default runtime fallback: https://ollama.com/api)
# BUB_OLLAMA_API_BASE=https://ollama.com/api

# ---------------------------------------------------------------------------
# Runtime behavior
# ---------------------------------------------------------------------------
# BUB_MAX_TOKENS=4096
# BUB_MAX_STEPS=100
# BUB_MODEL_TIMEOUT_SECONDS=300
# BUB_SYSTEM_PROMPT=You are a coding agent.
# BUB_HOME=~/.bub
# BUB_WORKSPACE_PATH=/absolute/path/to/workspace
# BUB_TAPE_NAME=bub

# ---------------------------------------------------------------------------
# Telegram channel (optional)
# ---------------------------------------------------------------------------
# BUB_TELEGRAM_ENABLED=true
# BUB_TELEGRAM_TOKEN=123456:telegram-bot-token
# JSON array recommended:
# BUB_TELEGRAM_ALLOW_FROM='["123456789","my_username"]'
# BUB_TELEGRAM_ALLOW_CHATS='["123456789","-1001234567890"]'
# BUB_TELEGRAM_PROXY=http://127.0.0.1:1080

# ---------------------------------------------------------------------------
# Discord channel (optional)
# ---------------------------------------------------------------------------
# BUB_DISCORD_ENABLED=true
# BUB_DISCORD_TOKEN=discord_bot_token
# JSON array recommended:
# BUB_DISCORD_ALLOW_FROM='["123456789012345678","my_discord_name"]'
# BUB_DISCORD_ALLOW_CHANNELS='["123456789012345678"]'
# Optional:
# BUB_DISCORD_COMMAND_PREFIX=!
# BUB_DISCORD_PROXY=http://127.0.0.1:7890

# ---------------------------------------------------------------------------
# Example minimal OpenRouter setup
# ---------------------------------------------------------------------------
# BUB_MODEL=openrouter:qwen/qwen3-coder-next
# OPENROUTER_API_KEY=sk-or-...