.env.example

# Android Repository Bot environment example.
#
# Copy this file to `.env` and replace every required placeholder before
# running `uv run androidrepo-bot` or `docker compose up --build bot`.
# The bot reads `.env` plus process environment variables prefixed with `AR_`.
# Empty optional token values are ignored.

# Telegram
# Required. Bot token from BotFather.
AR_BOT_TOKEN=replace-with-your-bot-token

# Required. Staff supergroup ID accepted by the middleware.
# Supergroup and channel IDs usually start with `-100`.
AR_STAFF_CHAT_ID=-1001234567890

# Required. Message thread ID for the staff topic where `/post`, callbacks, and
# `/cancel` are accepted. Must be a positive integer.
AR_POST_TOPIC_ID=123

# Required. Message thread ID for the staff topic that receives best-effort
# operational audit events. Must be a positive integer.
AR_LOG_TOPIC_ID=456

# Required. Target channel ID where confirmed posts are published.
# The bot must be allowed to post in this channel.
AR_CHANNEL_ID=-1009876543210

# Runtime logging
# Optional. Accepted values: CRITICAL, ERROR, WARNING, INFO, DEBUG.
AR_LOG_LEVEL=INFO

# AI generation
# Required. OpenCode Zen API key used by the PydanticAI post generator.
AR_OPENCODE_ZEN_API_KEY=replace-with-your-opencode-zen-api-key

# Optional. OpenCode Zen model identifier.
AR_OPENCODE_ZEN_MODEL=deepseek-v4-flash

# Repository providers
# Optional. Leave blank for anonymous provider requests. Set these for higher
# GitHub/GitLab rate limits or private provider access if the deployed bot
# should support it.
AR_GITHUB_TOKEN=
AR_GITLAB_TOKEN=

# Persistence
# Required. Async SQLAlchemy PostgreSQL URL.
#
# Use the `postgres` host when the bot runs through Docker Compose because that
# is the Compose service name. Use `localhost` when running the bot directly on
# the host against the Compose PostgreSQL port.
AR_DATABASE_URL=postgresql+asyncpg://androidrepo:androidrepo@postgres:5432/androidrepo