feat: add Telegram bot for remote quota monitoring

Author: FammasMaz

.env.example

@@ -250,4 +250,28 @@ OAUTH_REFRESH_INTERVAL=600 # Default is 600 seconds (10 minutes)
 # setup/validation flow on startup. This is highly recommended for non-interactive
 # environments like Docker containers or automated scripts.
 # Ensure your credentials in 'oauth_creds/' are valid before enabling this.
-SKIP_OAUTH_INIT_CHECK=false
+SKIP_OAUTH_INIT_CHECK=false
+
+
+# ------------------------------------------------------------------------------
+# | [TELEGRAM] Telegram Bot Configuration                                      |
+# ------------------------------------------------------------------------------
+#
+# Optional: Enable a Telegram bot to query quota stats from your phone.
+#
+# Setup:
+#   1. Message @BotFather on Telegram and send /newbot
+#   2. Follow the prompts to create your bot
+#   3. Copy the token and paste it below
+#   4. Message @userinfobot to get your Telegram user ID
+#   5. Add your user ID to TELEGRAM_ALLOWED_USERS (comma-separated for multiple)
+#   6. Run: python -m src.proxy_app.telegram_bot
+#
+
+# Bot token from @BotFather (required for Telegram bot)
+TELEGRAM_BOT_TOKEN=""
+
+# Comma-separated list of Telegram user IDs allowed to use the bot
+# Get your ID by messaging @userinfobot on Telegram
+# Example: TELEGRAM_ALLOWED_USERS="123456789,987654321"
+TELEGRAM_ALLOWED_USERS=""

docker-compose.yml

@@ -49,3 +49,21 @@ services:
       timeout: 10s
       retries: 3
       start_period: 30s
+
+  telegram-bot:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: llm-telegram-bot
+    restart: unless-stopped
+    command: python -m src.proxy_app.telegram_bot
+    volumes:
+      - ./.env:/app/.env:ro
+    environment:
+      - PYTHONUNBUFFERED=1
+      # Point to the llm-proxy container
+      - PROXY_HOST=llm-proxy
+      - PROXY_PORT=8317
+    depends_on:
+      llm-proxy:
+        condition: service_healthy

requirements.txt

@@ -25,3 +25,6 @@ customtkinter
 
 # For building the executable
 pyinstaller
+
+# Telegram bot for quota monitoring
+python-telegram-bot>=21.0