Environment variables - Bumblebee

Set variables in .env at the repo root (gitignored, loaded automatically) or as system/Railway env vars.

Platform tokens

Variable	Purpose
`TELEGRAM_TOKEN`	Telegram bot token (must match `token_env` in entity YAML)
`DISCORD_TOKEN`	Discord bot token
`BUMBLEBEE_TELEGRAM_OPERATOR_IDS`	Comma-separated Telegram user IDs for `/privacy` operators. Merged with YAML `operator_user_ids`.

Deployment

Variable	Default	Purpose
`BUMBLEBEE_DEPLOYMENT_MODE`	`local`	`local` or `hybrid_railway`
`BUMBLEBEE_INFERENCE_PROVIDER`	derived	`local`, `remote_gateway` (home tunnel gateway), `openrouter`, or `venice` (hosted OpenAI-compatible APIs for optional harness testing). See Hosted inference (testing).
`BUMBLEBEE_INFERENCE_BASE_URL`	—	Gateway: tunnel root URL (no path). Hosted presets: optional override; otherwise defaults are baked in per provider. Must always be the root before `/v1`.
`BUMBLEBEE_INFERENCE_TIMEOUT`	`120`	Inference request timeout (seconds)
`BUMBLEBEE_INFERENCE_GATEWAY_TOKEN`	—	Bearer token for `remote_gateway` (home inference gateway)
`BUMBLEBEE_INFERENCE_API_KEY_ENV`	—	Env var name for the Bearer token (gateway or hosted, depending on provider)
`BUMBLEBEE_INFERENCE_PASS_NUM_CTX`	—	`true` / `false`: send Ollama-style `options.num_ctx` on chat. Use `false` for strict OpenAI-compatible hosts (OpenRouter, Venice, etc.).
`OPENROUTER_API_KEY`	—	Bearer key when `BUMBLEBEE_INFERENCE_PROVIDER=openrouter` (unless overridden via `BUMBLEBEE_INFERENCE_API_KEY_ENV` / YAML).
`VENICE_API_KEY`	—	Bearer key when `BUMBLEBEE_INFERENCE_PROVIDER=venice` (unless overridden).
`BUMBLEBEE_TIMEZONE`	—	IANA timezone (e.g. `America/New_York`)

Ollama

Variable	Default	Purpose
`OLLAMA_HOST`	`http://127.0.0.1:11434`	Override Ollama URL

Database

Variable	Purpose
`DATABASE_URL`	Postgres connection string. When set, all structured memory uses Postgres instead of SQLite.

Execution

Variable	Default	Purpose
`BUMBLEBEE_EXECUTION_RPC_URL`	—	Remote execution host URL
`BUMBLEBEE_EXECUTION_RPC_TOKEN`	—	Bearer token for execution RPC
`BUMBLEBEE_EXECUTION_WORKSPACE_DIR`	—	Pin workspace root (e.g. `/app/data` on Railway). Also anchors the persistent venv (`$WORKSPACE/.venv`) and `HOME` for Railway entrypoint.
`BUMBLEBEE_SKIP_VOLUME_VENV`	`0`	Set to `1` to use the image Python instead of `$WORKSPACE/.venv` (debug only).
`BUMBLEBEE_VOLUME_HOME`	`$WORKSPACE/.home`	Override `HOME` on the volume (pip / Playwright caches).
`BUMBLEBEE_EXECUTION_REQUIRE_RAILWAY`	`false`	Block all local execution when not on Railway

Home gateway

Variable	Default	Purpose
`BUMBLEBEE_PYTHON`	—	Optional full path to `python3` for `scripts/gateway.sh` when the interpreter on `PATH` is not the one with Bumblebee installed (common on macOS with multiple Pythons).
`INFERENCE_GATEWAY_TOKEN`	—	Bearer token (must match worker’s `BUMBLEBEE_INFERENCE_GATEWAY_TOKEN`)
`OLLAMA_BASE_URL`	`http://127.0.0.1:11434`	Upstream Ollama URL
`INFERENCE_GATEWAY_HOST`	`127.0.0.1`	Gateway listen address
`INFERENCE_GATEWAY_PORT`	`8010`	Gateway listen port
`INFERENCE_GATEWAY_BACKEND_TIMEOUT`	`120`	Timeout for Ollama requests
`INFERENCE_GATEWAY_MAX_BODY_BYTES`	`8000000`	Max request body size

Object storage

Variable	Purpose
`BUMBLEBEE_ATTACHMENTS_BACKEND`	`local_disk` or `object_s3_compat`
`BUMBLEBEE_S3_ENDPOINT_URL`	S3-compatible endpoint
`BUMBLEBEE_S3_BUCKET`	Bucket name
`BUMBLEBEE_S3_ACCESS_KEY`	Access key
`BUMBLEBEE_S3_SECRET_KEY`	Secret key

Optional tools

Variable	Purpose
`FIRECRAWL_API_KEY`	Firecrawl key for enhanced web search/scrape
`FAL_API_KEY`	Fal key for image generation
`HOME_ASSISTANT_URL`	Home Assistant API URL for IoT tools
`HOME_ASSISTANT_TOKEN`	Home Assistant Long-Lived Access Token
`MASTODON_URL`	Mastodon instance URL for social broadcast tools
`MASTODON_ACCESS_TOKEN`	Mastodon access token
`X_API_KEY`	X (Twitter) API Key
`X_API_SECRET`	X (Twitter) API Secret
`X_ACCESS_TOKEN`	X (Twitter) Access Token
`X_ACCESS_SECRET`	X (Twitter) Access Secret

Railway

Variable	Purpose
`BUMBLEBEE_ENTITY`	Entity name to run (e.g. `canary`)
`BUMBLEBEE_RAILWAY_ROLE`	`worker` or `api`
`PORT`	API listen port (default `8080`)