v1.7 live · Bot API 9.6 · 19 commands · 23 references

AI builds production-ready
Telegram bots.

BotForge is a skill pack for Claude Code, Cursor, Codex, and any LLM. It turns your AI assistant into a senior Telegram engineer. Architecture before code. Every time.

Get started → View on GitHub
0
Commands
0
References
0
Payment providers
0
Languages
Side by side

Why BotForge exists.

The same business goal, asked to the same LLM. One side fails. The other ships.

💬 Same prompt. Same LLM. Two very different outcomes.
user prompt
>
plain LLM
with BotForge
⚠️

Without BotForge

what the LLM gives you alone
800-line
main.py
    ✨

    With BotForge

    production-ready in one shot
    app/bot/
    app/handlers/
    app/services/
    app/repositories/
    app/integrations/
    Dockerfile + tests

      Same goal. One monolith. One shippable project.

      Working example

      See the VIP bot in action.

      Reference bot from examples/01-vip-media-bot — every message is generated by real code.

      BF
      @cinema_vip_bot
      online

      Real bot. Real flow. Real code.

      • User starts the bot

        handlers/common.py handles /start and returns the main menu.

      • Inline menu nav

        callback_query routes to subscription.show_vip. Thin handler.

      • Payment invoice

        PaymentService creates order, StarsProvider returns a pay URL.

      • Idempotent webhook

        Duplicate successful_payment is caught by is_processed().

      • Access granted

        Subscription activated, invite link issued, audit logged.

      How it works

      Three rules your AI cannot break.

      Enforced through the skill prompt, not style guides. The AI refuses to violate them.

      01 — ARCHITECTURE

      No monoliths.

      Handlers, services, repositories, integrations — layered from day one.

      02 — PRODUCTION

      No drafts.

      Docker, Postgres, Alembic, .env, webhook — in the first generation.

      03 — EXTENSIBILITY

      No breakage.

      Adding the fifth feature is as easy as the first. Tests stay valid.

      19 slash commands

      All commands. Searchable. Clickable.

      Search by name or description. Click any command to see a live example.

      Features

      Everything included.

      Auth, payments, Mini Apps, moderation, i18n, observability, GDPR.

      Technical standard

      One curated stack.

      Swap a provider, not the framework.

      Head to head

      vs asking an LLM without a skill.

      5 minutes

      From zero to deployed bot.

      1

      Install the skill

      # one-liner
curl -fsSL https://raw.githubusercontent.com\
/Zulut30/telegram-skills/main/install.sh | bash
      2

      Ask your LLM

      /botforge-new SaaS
Task: VIP bot for cinema channel
Hosting: VPS, Docker, webhook
      3

      Deploy

      cd my-bot
cp .env.example .env
# fill BOT_TOKEN
make up

      Telegram Bot Development with AI

      BotForge is an open-source skill pack for Claude Code, Cursor, Codex, Aider and any LLM. It turns an AI assistant into a senior Telegram bot engineer that builds production-ready bots with aiogram 3, PostgreSQL, SQLAlchemy, Alembic migrations and Docker, grounded in the official Telegram Bot API 9.6.

      Use BotForge to create a Telegram VIP subscription bot, a channel bot, an admin bot, a shop bot, a Telegram Mini App with WebApp payments, Telegram Stars checkout, broadcast mailings and moderation tools — architecture before code, every time.

      Keywords: telegram bot development, create telegram bot with AI, aiogram 3 bot, python telegram bot, telegram bot api 9.6, telegram mini app, telegram stars payments, VIP subscription bot, admin bot telegram, claude code skill, cursor rules, codex agents, LLM skill, разработка телеграм ботов, создание телеграм бота, бот под ключ, aiogram бот.