Intelligent Telegram Content Automation Powered by OpenAI-Compatible APIs

Generate AI-written text and images, then auto-publish them to your Telegram channel on a fully automated schedule.

Developer Profile · Report Bug · Releases

• Overview
• Features
• Screenshots
• Requirements
• Installation
• Running the Application
• Activation Guide
  • Option A: OpenAI (Official)
  • Option B: OpenRouter
  • Option C: Other OpenAI-Compatible Providers
  • Telegram Bot Setup
• Configuration Reference
• Usage Guide
• Project Structure
• Troubleshooting
• FAQ
• Contributing
• License
• Developer

TeleAI-AutoPoster is a desktop application that automates content creation and publishing for Telegram channels. It leverages any OpenAI-compatible API to generate high-quality text posts and AI-generated images, then publishes them to your Telegram channel at a configurable interval — fully hands-free.

Whether you run a news channel, an educational page, a marketing funnel, or a personal blog on Telegram, TeleAI-AutoPoster handles the entire pipeline: ideation → writing → image generation → publishing.

Before installation, ensure you have:

• Python 3.9 or higher (Download)
• pip (included with Python)
• An OpenAI-compatible API key (see Activation Guide)
• A Telegram Bot Token (see Telegram Bot Setup)

Option A: Clone with Git

git clone https://github.com/BSHF-PER/TeleAI-AutoPoster.git
cd TeleAI-AutoPoster

Option B: Download ZIP

1. Go to the repository page.
2. Click the green Code button → Download ZIP.
3. Extract the ZIP file to your desired directory.

Open a terminal (Command Prompt, PowerShell, or Terminal) in the project folder and run:

pip install openai PyQt5 requests

If you encounter issues with PyQt5.QtSvg, install it explicitly:

pip install PyQt5 PyQt5-sip

Note: On some systems, you may need pip3 instead of pip, or python -m pip install instead.

python -c "import openai; import PyQt5; import requests; print('All dependencies OK')"

If you see All dependencies OK, you are ready to proceed.

Navigate to the project directory and run:

python Main.py

Or on Windows with the py launcher:

py Main.py

The TeleAI-AutoPoster window will open. You will see six tabs:

This section walks you through obtaining and configuring every required credential, step by step.

1. Go to https://platform.openai.com and create an account (or sign in).
2. Navigate to API Keys → Create new secret key.
3. Copy the key (starts with sk-).
4. In TeleAI-AutoPoster → Settings tab:
   • API Key: Paste your sk-... key.
   • Base URL: Leave empty (defaults to https://api.openai.com/v1).
   • Text Model: Enter a model name, e.g.:
     • gpt-4o (best quality)
     • gpt-4o-mini (fast and cheap)
     • gpt-3.5-turbo (legacy, cheapest)
   • Image Model: Enter dall-e-3 or dall-e-2. Leave empty to disable image generation.
5. Click Save Settings.

OpenRouter gives you access to hundreds of models (GPT-4o, Claude, Llama, Mistral, DeepSeek, etc.) through a single API key.

1. Go to https://openrouter.ai and create an account.

2. Go to Keys → Create Key.

3. Copy the key (starts with sk-or-).

4. In TeleAI-AutoPoster → Settings tab:

   • API Key: Paste your sk-or-... key.
   • Base URL: Enter exactly:

     https://openrouter.ai/api/v1
     

   • Text Model: Use OpenRouter model IDs, e.g.:
     • openai/gpt-4o
     • openai/gpt-4o-mini
     • anthropic/claude-sonnet-4
     • meta-llama/llama-3.1-70b-instruct
     • deepseek/deepseek-chat
     • mistralai/mistral-large
   • Image Model: Use OpenRouter model IDs, e.g.:
     • openai/gpt-image-2
     • black-forest-labs/flux.2-klein-4b

5. Click Save Settings.

Tip: Browse all available models at https://openrouter.ai/models.

TeleAI-AutoPoster works with any provider that exposes an OpenAI-compatible /v1/chat/completions endpoint.

Important: When using a custom Base URL, the provider must support the standard OpenAI chat completions format. Image generation requires a provider that supports the /v1/images/generations endpoint.

1. Open Telegram and search for @BotFather.
2. Send /newbot and follow the prompts:
   • Choose a display name for your bot.
   • Choose a username (must end in bot, e.g., MyAutoPosterBot).
3. BotFather will reply with your Bot Token — a string like:

   7123456789:AAH1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6
   

4. Copy this token.
5. Add the bot as an admin to your Telegram channel:
   • Open your channel → Settings → Administrators → Add Admin.
   • Search for your bot's username and add it.
   • Grant at minimum: Post Messages permission.
6. Get your Channel ID:
   • If your channel is public, use @your_channel_username.
   • If private, forward a message from the channel to @userinfobot or @getidsbot to get the numeric ID (e.g., -1001234567890).
7. In TeleAI-AutoPoster → Settings tab:
   • Bot Token: Paste the token from BotFather.
   • Channel ID: Enter @your_channel or -100xxxxxxxxxx.
8. Click Save Settings.

All settings are stored in teleai_config.json in the project directory. You can edit this file directly or use the GUI.

1. Open the Control tab.
2. Verify your settings are saved (Settings tab → Save).
3. Click Start.
4. The agent will immediately:
   • Generate an AI text post based on your topic and rules.
   • Optionally generate a matching image (depending on Image Mode).
   • Publish everything to your Telegram channel.
   • Wait for the configured interval.
   • Repeat indefinitely.

• Click Stop in the Control tab.
• The agent finishes its current cycle gracefully, then halts.
• You can also close the application window (a confirmation dialog will appear).

1. Go to the Manual tab.
2. Enter your text and optionally attach a media file (image, video, or audio).
3. Set a scheduled date and time.
4. Click Add to Queue.
5. Manual content is processed before AI content in each cycle.

• The Control tab shows a real-time, color-coded log:
  • White — Info messages
  • Yellow — Warnings
  • Red — Errors
• Use the Level and Category dropdowns to filter logs.
• The stats bar shows total posts, images generated, and estimated API cost.

TeleAI-AutoPoster/
├── Main.py                 # Main application (single file)
├── teleai_config.json       # User configuration (auto-created)
├── teleai_database.db       # SQLite database (auto-created)
├── temp_images/             # Temporary AI-generated images (auto-cleaned)
├── README.md                # This file
└── LICENSE                  # MIT License

Q: Can I use this with a free API? A: Yes. Providers like Groq offer generous free tiers. Local LLMs via Ollama are completely free. Set the Base URL accordingly.

Q: Does it support multiple channels? A: The current version (v1.0.2) supports one Telegram channel per instance. Run multiple instances with different config files for multiple channels.

Q: Can I use it without image generation? A: Yes. Leave the Image Model field empty, or set Image Mode to "Never" in the Content tab.

Q: Is my API key stored securely? A: The key is stored in teleai_config.json in plain text. Keep this file private and do not commit it to version control.

Q: What happens if the API is temporarily unavailable? A: The agent logs the error and retries after 60 seconds. It does not crash on transient failures.

Q: Can I customize the content language? A: Yes. Write your Topic and Rules in any language. The AI will generate content in the language of your prompt.

Contributions are welcome. Please follow these steps:

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/your-feature.
3. Commit your changes: git commit -m "Add your feature".
4. Push to the branch: git push origin feature/your-feature.
5. Open a Pull Request.

This project is licensed under the MIT License — see the LICENSE file for details.

Behzad Shahbazi Fard
Persian Developer

github.com/BSHF-PER

_{TeleAI-AutoPoster v1.0.2 · Built with Python, PyQt5 & OpenAI API · 2026}