.env.example
Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.
NEXT_PUBLIC_APP_URL
App Public URL of the deployed app. In dev, leave blank it's derived from PORT.
DATABASE_URL
secret
Database (required) Postgres with the pgvector extension enabled. Neon's free tier works.
BETTER_AUTH_SECRET
secret
Auth (required) Random 32+ char string. Generate with: openssl rand -base64 32
COMPOSIO_API_KEY
secret
Composio (required) Global API key for the Composio SDK. Get one free at https://dashboard.composio.dev/login?flow=developer
CRON_SECRET
secret
Cron auth (required) Random 32+ char string. Used to authenticate /api/cron/* endpoints. On Vercel, this is auto-injected when crons are…
TELEGRAM_BOT_TOKEN
secret
Telegram bot (optional Telegram features disabled when these are blank) Create a bot via @BotFather to get the token + username
TELEGRAM_BOT_USERNAME
secret
TELEGRAM_WEBHOOK_SECRET
secret
Random secret used to verify incoming Telegram webhook calls
REDIS_URL
secret
Redis (optional resumable streams disabled when blank, basic streaming still works) Used for resumable streams, streaming state, abort…
RATE_LIMIT_ENABLED
Agent rate limits (optional) Enabled by default. Set to false to bypass chat, cron, and Telegram rate limits.
RATE_LIMIT_CHAT_PER_MINUTE
Defaults: 20 chat messages/minute, 500 chat messages/day, 100 cron runs/day, and 20 Telegram messages/minute per user.
RATE_LIMIT_CHAT_PER_DAY
RATE_LIMIT_CRON_PER_DAY
RATE_LIMIT_TELEGRAM_PER_MINUTE
RATE_LIMIT_FAIL_MODE
Redis failure posture. Defaults to open in development, closed otherwise. Set explicitly to open or closed to override.