TG-Bale/GEMINI.md

Tele2Bale Project Context

This project is a Python-based automation tool designed to transfer files and media from a Telegram bot to Bale's "Saved Messages" using a Userbot. It uses a multi-process architecture with a file-based queue system to ensure stability and reliable delivery of large files (bypassing the 50MB bot limit).

Architecture Overview

The application is split into two main components coordinated by a central runner:

1. Orchestrator (main.py): Spawns and manages two separate processes: the Telegram bot and the Bale worker.
2. Telegram Bot (telebot.py):
   • Built using Pyrogram.
   • Handles user interactions, receives media, and extracts URLs.
   • Manages the task queue by writing to queue/tasks.jsonl.
   • Provides a "Safe Mode" for ZIP encryption.
   • Monitors queue/status.jsonl for real-time feedback.
3. Bale Worker (bale.py):
   • Built using aiobale.
   • Operates as a Userbot (logs in with a phone number) to allow uploading files larger than 50MB.
   • Consumes tasks from the queue sequentially.
   • Downloads files from direct URLs if necessary.
   • Performs ZIP encryption when Safe Mode is enabled.
   • Uploads files to the user's Saved Messages (BALE_TARGET_ID).

Key Files and Directories

• main.py: Entry point that starts both the bot and the worker.
• telebot.py: Telegram bot logic.
• bale.py: Bale userbot worker logic.
• queue/: JSONL files for task management and status reporting.
• downloads/: Temporary storage for files.

Development & Configuration

Environment Variables (.env)

• API_ID, API_HASH, BOT_TOKEN: Telegram API credentials.
• BALE_PHONE: Phone number for Bale authentication (+98...).
• BALE_TARGET_ID: UID of the target chat in Bale (e.g., Saved Messages ID).

Building and Running

1. Install dependencies: pip install -r requirements.txt
2. Initial Setup: Run python3 bale.py manually once to log in and create the bale_userbot.session file. You will need to enter the verification code from Bale.
3. Run the application: python3 main.py

Conventions

• Userbot for Large Files: Bale bots are limited to 50MB. This project uses a Userbot to bypass this restriction.
• Process Isolation: The bot and worker are independent and communicate via files.