FTMGram v3.5.0

Next-Gen Telegram MTProto & Bot API 10.3 Framework for Python

FTMGram is a high-performance, asynchronous Telegram MTProto client library and Bot API framework for Python. It supercharges both user accounts and bots with modern features like In-Message Buttons, AI Response Token Streaming, Bot Chat History Scanning, Turbo Multi-Worker Transfers, Ephemeral Overlays, and Telegram Stars 2.0.

⚡ Key Highlights in v3.5.0

• 🤖 Bot Chat History (get_bot_chat_history): Allows bots to retrieve message history across private chats and groups using safe, high-speed 100-ID batch scanning.
• ⚡ Turbo Multi-Worker Media Engine (fast_download): Download photos, videos, and large files at maximum network saturation with parallel chunk workers.
• 🎨 Fluent RichMessageBuilder DSL: Construct structured rich messages with in-message buttons (<tg-button-row>), expandable quotes, tables, and paragraphs effortlessly in Python.
• 🧠 Real-Time AI Streaming (stream_text & thinking): Seamlessly stream LLM tokens (OpenAI, Anthropic, Gemini, Groq, Ollama) directly to chat drafts with animated thinking placeholders and stop buttons.
• 🧹 Batch Chat Purge (purge_messages): Safely delete hundreds of messages in seconds with automatic RPC chunking and rate-limit handling.
• 💾 Memory Media Streaming (download_media_to_memory): Download media straight into an in-memory io.BytesIO buffer without disk I/O bottlenecks.
• 👥 Multi-Client Orchestrator (MultiClient): Manage and run dozens of bots and user accounts concurrently in a single event loop.

📦 Installation

pip install -U ftmgram

Or install with fast cryptographic acceleration:

pip install -U "ftmgram[fast]"

🚀 Quick Examples

1. Echo Bot with Filters

from ftmgram import Client, filters

app = Client("my_bot", bot_token="123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11")

@app.on_message(filters.text & filters.private)
async def echo(client, message):
    await message.reply(f"You said: {message.text}")

app.run()

2. In-Message Buttons (Bot API 10.3)

from ftmgram import Client
from ftmgram.helpers import RichMessageBuilder, Button

app = Client("my_bot", bot_token="TOKEN")

async def send_menu(chat_id: int):
    async with app:
        rich = (
            RichMessageBuilder()
            .title("💎 VIP Subscription")
            .paragraph("Select your desired membership tier:")
            .button_row(
                Button("Starter ($5)", data="plan_starter", style="primary"),
                Button("Pro ($15)", data="plan_pro", style="success"),
                Button("VIP ($25)", data="plan_vip", style="danger")
            )
            .build()
        )
        await app.send_rich_message(chat_id, rich)

app.run(send_menu(123456789))

3. Real-Time AI Token Streaming

from ftmgram import Client

app = Client("my_bot", bot_token="TOKEN")

async def fake_ai_stream():
    for word in ["Generating ", "answers ", "with ", "FTMGram ", "v3.5.0! 🚀"]:
        yield word

async def main():
    async with app:
        await app.stream_text(
            chat_id=123456789,
            stream=fake_ai_stream(),
            placeholder="AI is reasoning..."
        )

app.run(main())

4. Bot Chat History Retrieval

from ftmgram import Client

app = Client("my_bot", bot_token="TOKEN")

async def scan_history(chat_id: int):
    async with app:
        async for msg in app.get_bot_chat_history(chat_id, start_message_id=1, limit=50):
            print(f"[{msg.id}] {msg.text}")

app.run(scan_history(123456789))

📚 Documentation

Visit the official documentation portal: https://ftmgram.ftmbotzx.dev/

• Getting Started
• Methods Index
• Types Reference
• Bot API 10.3 Topics

📜 License

FTMGram is licensed under the GNU Lesser General Public License v3.0 (LGPL-3.0). Copyright (C) 2024-present FTM DEVELOPERZ.