Environment Variables
Complete reference for all environment variables Hybrix reads at startup. Store these in a .env file in your project root.
LLM provider keys
| Variable | Provider | Required |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic (Claude) | If using Anthropic agents |
| OPENAI_API_KEY | OpenAI (GPT) | If using OpenAI agents |
| GOOGLE_AI_KEY | Google (Gemini) | If using Google agents |
| MISTRAL_API_KEY | Mistral | If using Mistral agents |
| OLLAMA_HOST | Ollama (local) | Only if non-default host |
Channel tokens
| Variable | Channel | Notes |
|---|---|---|
| DISCORD_BOT_TOKEN | Discord | From the Discord Developer Portal |
| SLACK_BOT_TOKEN | Slack | xoxb- prefixed bot token |
| SLACK_SIGNING_SECRET | Slack | For verifying request signatures |
| TELEGRAM_BOT_TOKEN | Telegram | From @BotFather |
Gateway and system
| Variable | Default | Description |
|---|---|---|
| HYBRIX_PORT | 3000 | HTTP port for the gateway |
| HYBRIX_HOST | 127.0.0.1 | Bind address for the gateway |
| HYBRIX_LOG_LEVEL | info | Log verbosity: debug, info, warn, error |
| HYBRIX_CONFIG_PATH | ./hybrix.config.json | Path to config file |
| HYBRIX_SECRET | (generated) | Session encryption secret |
Example .env file
env
# LLM Providers
ANTHROPIC_API_KEY=sk-ant-api03-...
OPENAI_API_KEY=sk-proj-...
# Channels
DISCORD_BOT_TOKEN=MTIz...
SLACK_BOT_TOKEN=xoxb-...
SLACK_SIGNING_SECRET=abc123...
# Gateway
HYBRIX_PORT=3000
HYBRIX_LOG_LEVEL=infoNever commit your
.env file to version control. The hybrix init command automatically adds it to .gitignore.Use
hybrix env check to verify all required environment variables are set before starting the gateway.