.env.example to .env in the repo root for local development.
Vault
| Variable | Default | Description |
|---|---|---|
GRIND_VAULT_PATH | ~/.grind/vault.db | Path to the SQLite vault database |
GRIND_ENCRYPTION_KEY | — | AES encryption key for the vault (generated on init) |
Companion & AI
| Variable | Default | Description |
|---|---|---|
GRIND_ENABLE_COMPANION | false | Enable the AI companion |
GRIND_DEFAULT_MODEL | anthropic:claude-3-5-haiku-latest | Default model identifier (provider:model) |
ANTHROPIC_API_KEY | — | Anthropic API key |
OPENAI_API_KEY | — | OpenAI API key |
GOOGLE_GENERATIVE_AI_API_KEY | — | Google Gemini API key |
OLLAMA_BASE_URL | http://localhost:11434/v1 | Ollama endpoint for local models |
Turso (Cloud Sync)
| Variable | Default | Description |
|---|---|---|
TURSO_DATABASE_URL | — | Turso database URL (libsql://your-db.turso.io) |
TURSO_AUTH_TOKEN | — | Turso auth token |
Gateway
| Variable | Default | Description |
|---|---|---|
GRIND_GATEWAY_HOST | 127.0.0.1 | Host the gateway server binds to |
GRIND_GATEWAY_PORT | 5174 | Port the gateway listens on |
GRIND_GATEWAY_TOKEN | — | Shared secret for generic /hooks/inbound |
Telegram
| Variable | Description |
|---|---|
GRIND_TELEGRAM_BOT_TOKEN | Telegram bot token from @BotFather |
GRIND_TELEGRAM_WEBHOOK_SECRET | Secret for webhook verification |
GRIND_TELEGRAM_WEBHOOK_PATH | Webhook path (default: /hooks/telegram) |
Discord
| Variable | Description |
|---|---|
GRIND_DISCORD_PUBLIC_KEY | Discord app public key for Ed25519 signature verification |
GRIND_DISCORD_WEBHOOK_PATH | Webhook path (default: /hooks/discord) |
| Variable | Description |
|---|---|
GRIND_WHATSAPP_MODE | cloud (Cloud API) or web (Baileys) |
GRIND_WHATSAPP_VERIFY_TOKEN | Token for webhook challenge verification |
GRIND_WHATSAPP_APP_SECRET | App secret for HMAC signature verification |
GRIND_WHATSAPP_WEBHOOK_PATH | Webhook path (default: /hooks/whatsapp) |
GRIND_WHATSAPP_ACCESS_TOKEN | WhatsApp Cloud API access token |
GRIND_WHATSAPP_PAIRING_METHOD | qr or phone (for Baileys mode) |
GRIND_WHATSAPP_PAIRING_PHONE | Phone number for pairing code method |
GRIND_WHATSAPP_LINKED_AT | Timestamp of last Baileys session link |
Google Calendar
| Variable | Description |
|---|---|
GRIND_GOOGLE_CALENDAR_CHANNEL_TOKEN | Token for push notification verification |
GRIND_GOOGLE_CALENDAR_WEBHOOK_PATH | Webhook path (default: /hooks/google-calendar) |