Environment variables

blop reads environment variables for provider configuration, platform upload, debugging, and containerized browser runs. CLI flags take precedence over env vars, which take precedence over blop.config.ts. See Precedence.

Agent configuration

Variable	Used for
BLOP_AGENT_PROVIDER	Default agent provider (e.g. openai, anthropic)
BLOP_AGENT_MODEL	Default model name
BLOP_AGENT_API_KEY	Default API key — takes precedence over provider-native vars
BLOP_AGENT_BASE_URL	Override the provider’s base URL (for self-hosted or proxy endpoints)

Provider-native API keys

When BLOP_AGENT_API_KEY is unset, blop falls back to the provider-native variable matching the configured provider:

Variable	Provider
OPENAI_API_KEY	openai
ANTHROPIC_API_KEY	anthropic
GEMINI_API_KEY	google
GROQ_API_KEY	groq
XAI_API_KEY	xai
OPENROUTER_API_KEY	openrouter
MISTRAL_API_KEY	mistral
CEREBRAS_API_KEY	cerebras
NVIDIA_API_KEY	nvidia

See Agent providers for setup notes and model recommendations.

Platform upload

When both are set, the runner uploads BlopRunResult automatically after a run. Failures are logged but non-fatal.

Variable	Used for
BLOP_PLATFORM_URL	Blop Platform ingest URL
BLOP_API_KEY	Blop Platform API key

Containerized browser

Used by --containerized to control the separate warm browser container:

Variable	Used for
BLOP_PLAYWRIGHT_IMAGE	Docker image for the Playwright container
BLOP_PLAYWRIGHT_CONTAINER	Container name to create/reuse
BLOP_CAMOUFOX_IMAGE	Prebuilt Camoufox server image override
BLOP_CAMOUFOX_CONTAINER	Camoufox container name to create/reuse (default blop-camoufox)
BLOP_CAMOUFOX_NETWORK	Shared network override; falls back to BLOP_PLAYWRIGHT_NETWORK

Debugging

Variable	Used for
BLOP_DEBUG	When set, prints stack traces on CLI errors