Environment Variables
Configure whisp behavior using environment variables.
Environment Variables
Configure whisp behavior using environment variables. Environment variables override config file settings.
Provider API Keys
Set the API key for your chosen provider. Only one is required based on your default_provider.
OPENAI_API_KEY
Your OpenAI API key.
export OPENAI_API_KEY="sk-..."ANTHROPIC_API_KEY
Your Anthropic API key for Claude models.
export ANTHROPIC_API_KEY="sk-ant-..."GOOGLE_API_KEY
Your Google API key for Gemini models.
export GOOGLE_API_KEY="..."CEREBRAS_API_KEY
Your Cerebras API key.
export CEREBRAS_API_KEY="csk-..."Provider Configuration
WHISP_PROVIDER
Override the default AI provider. Options: openai, anthropic, ollama, gemini, cerebras
export WHISP_PROVIDER="anthropic"WHISP_MODEL
Override the model for the current provider.
export WHISP_MODEL="claude-sonnet-4-20250514"OLLAMA_URL
URL for your Ollama server (local AI). Default: http://localhost:11434
export OLLAMA_URL="http://localhost:11434"Daemon Configuration
WHISP_SOCKET
Path to the Unix socket for daemon communication. Default: /tmp/whisp.sock
export WHISP_SOCKET="/var/run/whisp.sock"WHISP_PID_FILE
Path to the daemon PID file. Default: /tmp/whisp.pid
export WHISP_PID_FILE="/var/run/whisp.pid"Behavior Configuration
WHISP_CONFIRM_DESTRUCTIVE
Whether to require confirmation for destructive commands. Default: true
export WHISP_CONFIRM_DESTRUCTIVE="false"NO_COLOR
Disable colored output (follows the NO_COLOR standard).
export NO_COLOR=1Shell Integration
WHISP_SESSION_ID
Session identifier for grouping related commands. Auto-generated if not set.
export WHISP_SESSION_ID="my-session"WHISP_SHELL
Override shell detection. Options: bash, zsh, fish
export WHISP_SHELL="zsh"Example Configuration
Add these to your shell rc file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish):
# Whisp configuration - choose ONE provider
# Option 1: OpenAI
export OPENAI_API_KEY="sk-your-key-here"
# Option 2: Anthropic Claude
# export ANTHROPIC_API_KEY="sk-ant-your-key-here"
# export WHISP_PROVIDER="anthropic"
# Option 3: Ollama (local, no API key needed)
# export WHISP_PROVIDER="ollama"
# export OLLAMA_URL="http://localhost:11434"
# Option 4: Google Gemini
# export GOOGLE_API_KEY="your-key-here"
# export WHISP_PROVIDER="gemini"
# Option 5: Cerebras
# export CEREBRAS_API_KEY="csk-your-key-here"
# export WHISP_PROVIDER="cerebras"
# Optional settings
export WHISP_CONFIRM_DESTRUCTIVE="true"