Metadata-Version: 2.5
Name: tobigram
Version: 2.5.0
Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
Project-URL: Homepage, https://github.com/TobiBotz/Tobigram
Project-URL: Documentation, https://docs.tobigram.com
Project-URL: Source, https://github.com/TobiBotz/Tobigram
Project-URL: Issues, https://github.com/TobiBotz/Tobigram/issues
Author-email: Dan <dan@pyrogram.org>
Maintainer: TobiBotz
License-Expression: LGPL-3.0-or-later
License-File: COPYING
License-File: COPYING.lesser
Keywords: api,chat,client,library,messenger,mtproto,python,telegram
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Communications
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: async-timeout>=4.0.3
Requires-Dist: orjson>=3.12.0
Requires-Dist: python-socks>=3.1.1
Requires-Dist: qrcode>=7.0
Requires-Dist: warpcrypto>=2.0.7
Provides-Extra: botapi
Requires-Dist: beautifulsoup4>=4.12; extra == 'botapi'
Requires-Dist: html5lib>=1.1; extra == 'botapi'
Requires-Dist: requests>=2.32; extra == 'botapi'
Provides-Extra: dev
Requires-Dist: jinja2>=3; extra == 'dev'
Requires-Dist: poethepoet>=0.32; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: pyyaml>=6; extra == 'dev'
Requires-Dist: twine>=5; extra == 'dev'
Provides-Extra: docs
Requires-Dist: furo>=2023; extra == 'docs'
Requires-Dist: sphinx-copybutton>=0.5; extra == 'docs'
Requires-Dist: sphinx>=7; extra == 'docs'
Provides-Extra: fast
Requires-Dist: uvloop<=0.22.1; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
Provides-Extra: mongo
Requires-Dist: motor>=3.5; extra == 'mongo'
Provides-Extra: redis
Requires-Dist: redis>=5.0; extra == 'redis'
Description-Content-Type: text/markdown

<p align="center">
    <a href="https://github.com/TobiBotz/Tobigram">
        <img
            src="assets/png/tobigram-icon-128.png"
            alt="Tobigram"
            height="128"
        />
    </a>
    <br />
    <b>Telegram MTProto API Framework for Python</b>
    <br />
    <a href="https://tobigram.com"> Homepage </a>
    •
    <a href="https://docs.tobigram.com"> Documentation </a>
    •
    <a href="https://t.me/TobigramNews"> News </a>
    •
    <a href="https://t.me/TobigramChat"> Chat </a>
    <br />
    <br />
    <a href="https://pypi.python.org/pypi/tobigram">
        <img
            src="https://img.shields.io/pypi/v/tobigram.svg?logo=pypi&logoColor=white&color=%23f55b25"
            alt="PyPI package version"
        />
    </a>
    <a href="https://pypi.python.org/pypi/tobigram">
        <img
            src="https://static.pepy.tech/badge/tobigram/month"
            alt="Downloads"
        />
    </a>
    <a href="https://pypi.python.org/pypi/tobigram">
        <img
            src="https://img.shields.io/pypi/pyversions/tobigram.svg?logo=python&logoColor=white&color=%23fd5216"
            alt="Python versions"
        />
    </a>
    <a href="https://github.com/TobiBotz/Tobigram/blob/dev/COPYING.lesser">
        <img
            src="https://img.shields.io/github/license/TobiBotz/Tobigram.svg?color=%23fd5216"
            alt="License"
        />
    </a>
</p>


## Tobigram

> Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots

Tobigram is an actively maintained Pyrogram fork for Python designed as a drop-in replacement for Pyrogram. Tobigram provides support for the latest Telegram features including Gifts, Stories, Topics, Business Accounts, and more.

```python
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()
```

**Tobigram** is a modern, elegant and asynchronous [MTProto API](https://docs.tobigram.com/topics/mtproto-vs-botapi) framework. It enables you to easily interact with the main Telegram API through a user account (custom client) or a bot identity (bot API alternative) using Python.

### Key Features

- **Ready**: Install Tobigram with `pip` or `uv` and start building your applications right away.
- **Drop-in Replacement**: 100% compatible with Pyrogram codebases — keep your existing imports with zero migration hassle.
- **Fast**: Boosted up by [WarpCrypto](https://github.com/TobiBotz/WarpCrypto), a high-performance cryptography library written in Rust.
- **Telegram Layer 229+ Native**: First-class support for Star Gifts, Stories, Forum Topics, Business Connections, and Reaction effects.
- **High-Speed Transfers**: Parallel DC chunk streaming with adaptive rate limiting and session pooling.
- **Advanced Proxy Support**: Built-in support for MTProxy (EE Fake-TLS with SNI), MTProto Web Proxy (WebSocket/TLS 1.3), and SOCKS5/HTTP.
- **Modern Python**: Fully compatible with Python 3.10 through Python 3.14+.
- **Type-hinted**: Comprehensive type hints across all methods and types for excellent editor autocomplete.
- **Async**: Fully asynchronous with native async/await for peak concurrency and responsiveness.
- **Powerful**: Full access to Telegram's MTProto API to execute any official client action and more.

### Installing

Stable version

```bash
pip install tobigram
```

Using uv (Recommended)

```bash
uv add tobigram
```

Dev version

```bash
pip install https://github.com/TobiBotz/Tobigram/archive/dev.zip --force-reinstall
```

Optional dependencies

```bash
pip install tobigram[fast]     # uvloop for better performance
```

### Resources

- Check out the [docs](https://docs.tobigram.com) to learn more about Tobigram, get started right away and discover more in-depth material for building your client applications.
- Join the [official channel](https://t.me/TobigramNews) and stay tuned for news, updates and announcements.
- Join the [official chat](https://t.me/TobigramChat) to communicate with people.

### Special Thanks

- **[Dan](https://github.com/delivrance)** The original creator of [Pyrogram](https://github.com/pyrogram/pyrogram).
- **[Kurimuzon Akuma](https://github.com/KurimuzonAkuma)** Creator and maintainer of [Kurigram](https://github.com/kurigram-org/kurigram).
- **[Riajul](https://github.com/rjriajul)** Creator of [Wzgram](https://github.com/rjriajul/wzgram) and author of [WarpCrypto](https://github.com/TobiBotz/WarpCrypto).
