example.env

# Required: Bot token from @BotFather
TELEGRAM_BOT_TOKEN=your_bot_token_here

# dev:
#CALMMAGE_SERVICE_REGISTRY_URL=http://localhost:8765
# prod:
#CALMMAGE_SERVICE_REGISTRY_URL=https://your-service-registry.example.com

# ----------------------------------------
# Botspot Components
# ----------------------------------------

# telegram user ids
BOTSPOT_ADMINS_STR="@username"
#BOTSPOT_FRIENDS_STR=""

# Event Scheduler
BOTSPOT_SCHEDULER_ENABLED=true
#BOTSPOT_SCHEDULER_TIMEZONE=UTC

# MongoDB
BOTSPOT_MONGO_DATABASE_ENABLED=true
#BOTSPOT_MONGO_DATABASE_CONN_STR=mongodb://localhost:27017
#BOTSPOT_MONGO_DATABASE_DATABASE=dev-project-name

# PostgreSQL (preferred for new bots; use Alembic in the app for migrations)
#BOTSPOT_POSTGRES_DATABASE_ENABLED=true
#BOTSPOT_POSTGRES_DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/dbname

# Telethon Manager
#BOTSPOT_TELETHON_MANAGER_ENABLED=true
#BOTSPOT_TELETHON_MANAGER_API_ID=null
#BOTSPOT_TELETHON_MANAGER_API_HASH=null
#BOTSPOT_TELETHON_MANAGER_SESSIONS_DIR=sessions
#BOTSPOT_TELETHON_MANAGER_AUTO_AUTH=true

# Trial Mode
#BOTSPOT_TRIAL_MODE_ENABLED=true
#BOTSPOT_TRIAL_MODE_PERIOD_PER_USER=86400
#BOTSPOT_TRIAL_MODE_GLOBAL_PERIOD=86400
# BOTSPOT_TRIAL_MODE_ALLOWED_USERS=["username1", "username2"]
# BOTSPOT_TRIAL_MODE_LIMIT_PER_USER=10
# BOTSPOT_TRIAL_MODE_GLOBAL_LIMIT=100

# User Data
BOTSPOT_USER_DATA_ENABLED=true
#BOTSPOT_USER_DATA_MIDDLEWARE_ENABLED=true
#BOTSPOT_USER_DATA_COLLECTION=botspot_users
#BOTSPOT_USER_DATA_CACHE_TTL=300
#BOTSPOT_USER_DATA_USER_TYPES_ENABLED=true

# Single User Mode
BOTSPOT_SINGLE_USER_MODE_ENABLED=false
#BOTSPOT_SINGLE_USER_MODE_USER=null

# Send Safe Settings
BOTSPOT_SEND_SAFE_ENABLED=true
#BOTSPOT_SEND_SAFE_WRAP_TEXT=false
#BOTSPOT_SEND_SAFE_SEND_LONG_MESSAGES_AS_FILES=true
#BOTSPOT_SEND_SAFE_SEND_PREVIEW_FOR_LONG_MESSAGES=false
#BOTSPOT_SEND_SAFE_PREVIEW_CUTOFF=200
#BOTSPOT_SEND_SAFE_WRAP_WIDTH=88
#BOTSPOT_SEND_SAFE_PARSE_MODE=HTML

# Admin Filter
#BOTSPOT_ADMIN_FILTER_NOTIFY_BLOCKED=true

# Chat Binder
#BOTSPOT_CHAT_BINDER_ENABLED=false
#BOTSPOT_CHAT_BINDER_MONGO_COLLECTION=chat_binder
#BOTSPOT_CHAT_BINDER_COMMANDS_VISIBLE=false
#BOTSPOT_CHAT_BINDER_REBIND_MODE=error
#BOTSPOT_CHAT_BINDER_CHECK_ACCESS=true

# Chat Fetcher
#BOTSPOT_CHAT_FETCHER_ENABLED=false
#BOTSPOT_CHAT_FETCHER_DB_CACHE_ENABLED=false
#BOTSPOT_CHAT_FETCHER_DEFAULT_DIALOGS_LIMIT=null

# LLM Provider
#BOTSPOT_LLM_PROVIDER_ENABLED=true
#OPENAI_API_KEY=
#ANTHROPIC_API_KEY=
#GEMINI_API_KEY=
#XAI_API_KEY=
#DEEPSEEK_API_KEY=
#BOTSPOT_LLM_PROVIDER_DEFAULT_MODEL=claude-3.7
#BOTSPOT_LLM_PROVIDER_DEFAULT_TEMPERATURE=0.7
#BOTSPOT_LLM_PROVIDER_DEFAULT_MAX_TOKENS=1000
#BOTSPOT_LLM_PROVIDER_DEFAULT_TIMEOUT=30
#BOTSPOT_LLM_PROVIDER_ALLOW_EVERYONE=false
#BOTSPOT_LLM_PROVIDER_SKIP_IMPORT_CHECK=false

# API Keys for LLM providers
#OPENAI_API_KEY=your_openai_key_here
#ANTHROPIC_API_KEY=your_anthropic_key_here
#XAI_API_KEY=your_grok_key_here
#GEMINI_API_KEY=your_gemini_key_here
#GOOGLE_API_KEY=your_google_api_key_here

#MISTRAL_API_KEY=your_mistral_key_here
#PERPLEXITY_API_KEY=your_perplexity_key_here
#AZURE_OPENAI_API_KEY=your_azure_openai_key_here
#AZURE_OPENAI_ENDPOINT=your_azure_endpoint_here


# Queue Manager
#BOTSPOT_QUEUE_MANAGER_ENABLED=false
#BOTSPOT_QUEUE_MANAGER_COLLECTION_NAME_PREFIX=botspot_queue_

# Auto Archive
#BOTSPOT_AUTO_ARCHIVE_ENABLED=false
#BOTSPOT_AUTO_ARCHIVE_DELAY=10

# Subscription Manager (credits + Stars subscriptions + trial caps)
# Requires MongoDB. Friends/admins bypass via BOTSPOT_FRIENDS_STR / BOTSPOT_ADMINS_STR.
#BOTSPOT_SUBSCRIPTION_MANAGER_ENABLED=false
#BOTSPOT_SUBSCRIPTION_MANAGER_REGISTER_COMMANDS=true
#BOTSPOT_SUBSCRIPTION_MANAGER_COLLECTION_PREFIX=billing_
#BOTSPOT_SUBSCRIPTION_MANAGER_CREDITS_PER_USD=100
#BOTSPOT_SUBSCRIPTION_MANAGER_STARS_PER_USD=100
#BOTSPOT_SUBSCRIPTION_MANAGER_MEDIA_COST_MULTIPLIER=1.6
#BOTSPOT_SUBSCRIPTION_MANAGER_CHAT_COST_MULTIPLIER=1.2
#BOTSPOT_SUBSCRIPTION_MANAGER_GRACE_DAYS=2
#BOTSPOT_SUBSCRIPTION_MANAGER_RECONCILE_INTERVAL_HOURS=6
#BOTSPOT_SUBSCRIPTION_MANAGER_SIGNATURE_SECRET=
#BOTSPOT_SUBSCRIPTION_MANAGER_PUBLIC_BASE_URL=https://example.com
#BOTSPOT_SUBSCRIPTION_MANAGER_STRIPE_SECRET_KEY=
#BOTSPOT_SUBSCRIPTION_MANAGER_STRIPE_WEBHOOK_SECRET=
#BOTSPOT_SUBSCRIPTION_MANAGER_STRIPE_ALLOW_LIVE=false
#BOTSPOT_SUBSCRIPTION_MANAGER_STRIPE_PRICE_IDS_JSON=
#BOTSPOT_SUBSCRIPTION_MANAGER_STRIPE_INTEGRATION_IDENTIFIER_PREFIX=botspot
#BOTSPOT_SUBSCRIPTION_MANAGER_YOOKASSA_SHOP_ID=
#BOTSPOT_SUBSCRIPTION_MANAGER_YOOKASSA_SECRET_KEY=
#BOTSPOT_SUBSCRIPTION_MANAGER_YOOKASSA_RETURN_URL=
#BOTSPOT_SUBSCRIPTION_MANAGER_YOOKASSA_USD_RATE=0
#BOTSPOT_SUBSCRIPTION_MANAGER_TON_WALLET_ADDRESS=
#BOTSPOT_SUBSCRIPTION_MANAGER_TON_USD_RATE=0
#BOTSPOT_SUBSCRIPTION_MANAGER_TRIAL_ENABLED=true
#BOTSPOT_SUBSCRIPTION_MANAGER_TRIAL_DURATION_DAYS=7
# 0 = no expiry (public free tier). Per-user daily caps: 0 = off.
#BOTSPOT_SUBSCRIPTION_MANAGER_TRIAL_USER_AUDIO_MINUTES_PER_DAY=0
#BOTSPOT_SUBSCRIPTION_MANAGER_TRIAL_USER_AUDIO_REQUESTS_PER_DAY=0
#BOTSPOT_SUBSCRIPTION_MANAGER_TRIAL_USER_CHAT_REQUESTS_PER_DAY=0
#BOTSPOT_SUBSCRIPTION_MANAGER_TRIAL_GLOBAL_COST_USD_PER_DAY=2.0

# ----------------------------------------
# Enabled by default
# ----------------------------------------

#BOTSPOT_PRINT_BOT_URL_ENABLED=true
#BOTSPOT_BOT_COMMANDS_MENU_ENABLED=true
BOTSPOT_ERROR_HANDLER_ENABLED=true
BOTSPOT_ERROR_HANDLER_EASTER_EGGS=true
#BOTSPOT_ERROR_HANDLER_DEVELOPER_CHAT_ID=123456789
#BOTSPOT_BOT_INFO_ENABLED=true
#BOTSPOT_BOT_INFO_HIDE_COMMAND=false
#BOTSPOT_BOT_INFO_SHOW_DETAILED_SETTINGS=true
#BOTSPOT_ASK_USER_ENABLED=true
#BOTSPOT_ASK_USER_DEFAULT_TIMEOUT=1200