Welcome to Tobigram’s Documentation!¶
Tobigram is an elegant, modern and asynchronous Telegram MTProto API framework for Python.
It is a fork of Pyrogram and a drop-in replacement — the distribution is pyrogram, the
import stays pyrogram, and existing code runs unchanged.
from pyrogram import Client, filters
app = Client("my_account")
@app.on_message(filters.private)
async def hello(client, message):
await message.reply("Hello from Tobigram!")
app.run()
What you get¶
Up to date with Telegram. Every parameter of every implemented method and type is checked against Bot API 10.2 and the TL schema at build time. Features walks what Telegram has shipped, in the order it shipped it — business accounts, paid media, gifts, stories, checklists, suggested posts, rich messages, ephemeral messages.
Conversations without state machines. Listeners waits for the next message or button press inline, inside the handler that asked for it.
Built to stay up. Opt-in client-side rate limiting, bounded memory on every transfer path, Rust cryptography, and a hot path measured rather than guessed — see Performance and Resource Budgets.
Portable sessions. Checksummed session strings that survive being copy-pasted, with every legacy format still decodable.
New here? Install Guide then Quick Start.
Introduction
Getting Started
Features
API Reference
Concepts
Updates & Filters
Configuration
Advanced
Help
- FAQ
- What is pyrogram?
- How is it different from Pyrogram?
- What Python versions are supported?
- How do I install tobigram?
- Can I use tobigram with uv?
- Do I need an API ID and hash?
- How do I start a Client?
- Can I use pyrogram synchronously?
- How do I handle progress for uploads and downloads?
- What are bound methods?
- Does pyrogram support parallel downloads?
- Does pyrogram support Stories?
- Does pyrogram support Gifts and Stars?
- Does pyrogram support Business Accounts?
- Does pyrogram support Rich Text (styled messages)?
- How do I enable debug logging?
- Can I wait for a user’s reply without a handler?
- How do I avoid FloodWait?
- Why does my bot use so much memory with many clients?
- Can I keep sessions in a database instead of a file?
- Where can I get help?
Telegram Raw API