Configuration

Environment variables reference for Delphi.

All configuration lives in .env in the project root. Copy .env.example to get started — the setup wizard does this automatically.

Variable	Default	Description
`TELEGRAM_BOT_TOKEN`	—	Your bot token from @BotFather
`TELEGRAM_ALLOWED_USER_IDS`	—	Comma-separated Telegram user IDs who can use the bot
`TELEGRAM_ALLOWED_CHAT_IDS`	—	Group/channel IDs (if empty, DMs only)

Only add Telegram user IDs belonging to yourself or your household. Granting access to colleagues, clients, or anyone outside your household means your personal Claude subscription is processing third-party requests — a violation of Anthropic's terms of service.

Agent behavior

Variable	Default	Description
`MAIN_EXTRA_TOOLS`	`*`	`*` = all tools; comma-list to restrict (e.g. `Bash,Read,Write`)

Voice transcription

Variable	Default	Description
`WHISPER_PROVIDER`	`none`	`none`, `openai`, or `local`
`OPENAI_API_KEY`	—	Required when `WHISPER_PROVIDER=openai`

Discord

Variable	Default	Description
`DISCORD_BOT_TOKEN`	—	Discord bot token (leave blank to disable Discord)
`DISCORD_ALLOWED_USER_IDS`	—	Comma-separated Discord user IDs (empty = allow all)
`DISCORD_ALLOWED_GUILD_IDS`	—	Comma-separated server IDs (empty = allow all)

Dreaming (nightly memory consolidation)

Variable	Default	Description
`DREAMING_ENABLED`	`false`	Enable nightly memory sweep
`DREAMING_LOOKBACK_DAYS`	`30`	Days of daily notes to sweep
`DREAMING_PROMOTION_THRESHOLD`	`0.6`	Score threshold to promote a memory to `DREAMS.md`

Dashboard

Variable	Default	Description
`DASHBOARD_PORT`	`8000`	Port for the internal dashboard

Never commit .env to git. It is gitignored by default. Keep your bot token and API keys private.