Skip to content

Environment Variables

Environment variables override values in ~/.snippbot/config.toml. Set them in your shell profile or before running snippbot start:

export ANTHROPIC_API_KEY=sk-ant-xxx
export SNIPPBOT_PORT=18781
snippbot start

Or inline:

ANTHROPIC_API_KEY=sk-ant-xxx snippbot start

Server

Variable	Default	Description
`SNIPPBOT_HOST`	`""` (dual-stack)	Daemon bind address (empty = IPv4 + IPv6)
`SNIPPBOT_PORT`	`18781`	Daemon API port
`SNIPPBOT_LOG_LEVEL`	`info`	Log level: `debug`, `info`, `warning`, `error`
`SNIPPBOT_DATA_DIR`	`~/.snippbot`	Data directory path
`SNIPPBOT_PROJECTS_DIR`	(empty)	Projects directory (defaults to `{data_dir}/projects`)

Security

Variable	Default	Description
`SNIPPBOT_API_KEY_REQUIRED`	`true`	Require auth for all endpoints
`SNIPPBOT_CORS_ORIGINS`	`http://localhost:5173`	Allowed CORS origins (comma-separated)
`SNIPPBOT_SESSION_EXPIRY`	`86400`	Session token expiry in seconds (24h)
`SNIPPBOT_INACTIVITY_TIMEOUT`	`1800`	Inactivity logout timeout in seconds (30m)

AI providers

Variable	Description
`ANTHROPIC_API_KEY`	Anthropic API key
`OPENAI_API_KEY`	OpenAI API key
`OPENROUTER_API_KEY`	OpenRouter API key
`GEMINI_API_KEY`	Google Gemini API key
`DEEPSEEK_API_KEY`	DeepSeek API key
`GROK_API_KEY`	Grok API key
`GROQ_API_KEY`	Groq API key
`MISTRAL_API_KEY`	Mistral API key

Voice / audio

Variable	Description
`ELEVENLABS_API_KEY`	ElevenLabs TTS API key
`HUME_API_KEY`	Hume AI voice API key
`WHISPER_MODEL`	Local Whisper STT model (e.g., `base`, `small`, `medium`)

Integrations

Variable	Description
`BRAVE_SEARCH_API_KEY`	Brave Search API key
`GITHUB_TOKEN`	GitHub personal access token
`SLACK_BOT_TOKEN`	Slack bot token

Resource limits

Variable	Default	Description
`SNIPPBOT_MAX_CONCURRENT_TASKS`	`4`	Maximum concurrent task executions
`SNIPPBOT_DEFAULT_TIMEOUT`	`300`	Default task timeout in seconds

Sandbox

The code-execution sandbox is not configured with environment variables. Its mode, network policy, workspace access, resources, and runtime preference are set through the Sandbox settings page (or PUT /api/sandbox/config) and persisted to ~/.snippbot/sandbox_config.json. See Run Code in Sandbox.

The only sandbox-related environment variables the code reads are consumed by the claude-native tool bridge (a separate out-of-process helper), not the main daemon sandbox:

Variable	Default	Description
`SNIPPBOT_SANDBOX_MODE`	`all`	Sandbox mode used by the claude-native Bash bridge (`off`, `selective`, `all`)
`SNIPPBOT_SANDBOX_RISK_THRESHOLD`	`0.5`	Risk threshold used by the claude-native Bash bridge
`SNIPPBOT_CONTAIN_CUSTOM_PYTHON`	(unset)	Overrides + locks the `contain_custom_python` sandbox setting when set (`1`/`0`); when unset, the UI toggle applies. On ⇒ installed `custom_python` tools run contained under Safe/Strict; off ⇒ blocked
`SNIPPBOT_STRICT_DAEMON_LOOPBACK`	(unset)	Overrides + locks the `strict_daemon_loopback` sandbox setting when set. On ⇒ a Strict-contained tool may reach the local daemon over an egress-blocked network (Linux; full isolation on Docker Desktop)

Browser

Variable	Default	Description
`SNIPPBOT_BROWSER_HEADLESS`	`true`	Run browser in headless mode
`SNIPPBOT_BROWSER_STEALTH`	`true`	Enable stealth mode (bot detection evasion)