Metadata-Version: 2.4
Name: irenogram
Version: 2.3.90
Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
Project-URL: Homepage, https://github.com/abirxdhack/irenogram
Project-URL: Source, https://github.com/abirxdhack/irenogram
Project-URL: Issues, https://github.com/abirxdhack/irenogram/issues
Project-URL: Community, https://t.me/ISmartCoder
Project-URL: Author, https://github.com/abirxdhack
Author-email: Abir Arafat Chawdhury <abirxdhackz@gmail.com>
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.8
Classifier: Programming Language :: Python :: 3.9
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 :: 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.8
Requires-Dist: pyaes<=1.6.1
Requires-Dist: pysocks<=1.7.1
Provides-Extra: dev
Requires-Dist: hatch<=1.16.2; extra == 'dev'
Requires-Dist: pytest-asyncio<=1.3.0; extra == 'dev'
Requires-Dist: pytest-cov<=7.0.0; extra == 'dev'
Requires-Dist: pytest<=9.0.2; extra == 'dev'
Requires-Dist: twine<=6.2.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: furo; extra == 'docs'
Requires-Dist: pymediainfo; extra == 'docs'
Requires-Dist: pysocks; extra == 'docs'
Requires-Dist: sphinx; extra == 'docs'
Requires-Dist: sphinx-copybutton; extra == 'docs'
Provides-Extra: fast
Requires-Dist: tgcrypto<=1.2.5; extra == 'fast'
Requires-Dist: uvloop<=0.21.0; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
Description-Content-Type: text/markdown

<p align="center">
    <a href="https://github.com/abirxdhack/irenogram">
        <img src="docs_static/irenogram.png" alt="Irenogram" width="128">
    </a>
    <br>
    <b>Telegram MTProto API Framework for Python</b>
    <br>
    <a href="https://github.com/abirxdhack">
        Homepage
    </a>
    •
    <a href="https://abirxdhack.github.io/irenogram">
        Documentation
    </a>
    •
    <a href="https://github.com/abirxdhack/irenogram/issues">
        Issues
    </a>
    •
    <a href="https://t.me/ISmartCoder">
        Support Chat
    </a>
</p>

## Irenogram

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

```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 Irenogram!")

app.run()
```

**Irenogram** is a modern, elegant and asynchronous [MTProto API](https://abirxdhack.github.io/irenogram) 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 Irenogram with pip and start building right away. Drop-in replacement for Pyrogram.
- **Easy**: Makes the Telegram API simple and intuitive, with full type hints for IDE support.
- **Elegant**: Low-level details abstracted, presented in convenient, Pythonic ways.
- **Fast**: Optimized MTProto implementation with C-accelerated cryptography via TgCrypto.
- **Type-hinted**: Complete type annotations across all 2,200+ Telegram types for excellent IDE support.
- **Async**: Fully asynchronous (also synchronous if needed, for convenience).
- **Powerful**: Full Telegram API access including Managed Bots, Business Accounts, Advanced Polls.

### Rare & Exceptional Features

- **Layer 224 Complete** — All 2,200+ MTProto types with full type coverage
- **Managed Bots** — Create and control multiple bots via single account API
- **Business Accounts** — Full support for Telegram Business API across all methods
- **Advanced Polls** — Quiz mode with multiple correct answers, revoting, hidden results, dynamic options
- **In-Memory Sessions** — Zero-disk temporary sessions for stateless deployments
- **Session Strings** — Export/import sessions without file I/O
- **Zero Migration** — 100% backward compatible with existing Pyrogram code
- **Multiple Storage** — SQLite, Memory, File, MongoDB storage backends

### Installing

```bash
pip install irenogram
```

### Resources

- Check out the docs at https://abirxdhack.github.io/irenogram to learn more, get started and discover advanced features.
- Join the community at https://t.me/Irenogram for support, updates and announcements.

### License

Irenogram is distributed under the terms of the [GNU Lesser General Public License v3.0](https://www.gnu.org/licenses/lgpl-3.0.html).
