Skip to content

Configuration

All configuration is done via environment variables.

Bot Settings

Variable Description Required
BOT_TOKEN Discord bot token Yes
BOT_CLIENT_ID Discord application client ID Yes
BOT_DEBUG Enable debug logging (true/false) No

LLM Settings

Variable Description Required
LLM_BASE_URL OpenAI-compatible API base URL For LLM features
LLM_API_KEY API key for the LLM provider For LLM features
LLM_DEFAULT_MODEL Default model for /llm chat For LLM features
LLM_IMAGE_API_KEY API key for image generation (can differ from chat key) For image gen
LLM_IMAGE_MODEL Model for /llm image (default: dall-e-3) No
Variable Description Default
LAVALINK_DISCOVERY_MODE local or k8s for Kubernetes node discovery local
LAVALINK_HOST Lavalink host 127.0.0.1
LAVALINK_PORT Lavalink port 2333
LAVALINK_PASSWORD Lavalink password youshallnotpass

Kubernetes Discovery

These are only needed when LAVALINK_DISCOVERY_MODE=k8s:

Variable Description Default
LAVALINK_K8S_NAMESPACE Kubernetes namespace for Lavalink service discovery default
LAVALINK_K8S_SERVICE_NAME Kubernetes service name for Lavalink lavalink
LAVALINK_K8S_SERVICE_PORT Kubernetes service port for Lavalink 2333

Langfuse Settings

Variable Description Required
LANGFUSE_PUBLIC_KEY Langfuse public key For tracing
LANGFUSE_SECRET_KEY Langfuse secret key For tracing
LANGFUSE_HOST Langfuse host URL For tracing

Example .env File

# Bot
BOT_TOKEN=your-bot-token
BOT_CLIENT_ID=your-client-id
BOT_DEBUG=false

# Lavalink
LAVALINK_HOST=127.0.0.1
LAVALINK_PORT=2333
LAVALINK_PASSWORD=youshallnotpass

# LLM
LLM_BASE_URL=https://api.example.com/v1
LLM_API_KEY=your-api-key
LLM_DEFAULT_MODEL=gpt-4

# Langfuse (optional)
LANGFUSE_PUBLIC_KEY=pk-...
LANGFUSE_SECRET_KEY=sk-...
LANGFUSE_HOST=https://langfuse.example.com