Metadata-Version: 2.4
Name: hypergram
Version: 1.2.26
Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
Project-URL: Documentation, https://docs.hypergram.icu
Project-URL: Source, https://github.com/Shadowc89/hypergram
Project-URL: Issues, https://github.com/Shadowc89/hypergram/issues
Project-URL: Community, https://t.me/hypergram_chat
Author-email: Saif <Saif@hypergram.org>
Maintainer: hypergram
License-Expression: LGPL-3.0-or-later
License-File: COPYING
License-File: COPYING.lesser
Keywords: hypergram,hypergrambots,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 :: 3.14
Classifier: Programming Language :: Python :: 3.15
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: python-socks[asyncio]<=2.8.1
Provides-Extra: dev
Requires-Dist: hatch<=1.17.0; extra == 'dev'
Requires-Dist: keyring<=25.7.0; extra == 'dev'
Requires-Dist: pytest-asyncio<=1.4.0; extra == 'dev'
Requires-Dist: pytest-cov<=7.1.0; extra == 'dev'
Requires-Dist: pytest<=9.1.1; extra == 'dev'
Requires-Dist: twine<=6.2.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: pygments<=2.20.0; extra == 'docs'
Requires-Dist: shibuya<=2026.5.19; extra == 'docs'
Requires-Dist: sphinx-autobuild<=2025.8.25; extra == 'docs'
Requires-Dist: sphinx-copybutton<=0.5.2; extra == 'docs'
Requires-Dist: sphinx-design<=0.7.0; extra == 'docs'
Requires-Dist: sphinx-iconify<=0.3.0; extra == 'docs'
Requires-Dist: sphinx<=9.1.0; extra == 'docs'
Provides-Extra: fast
Requires-Dist: tgcrypto<=1.2.5; extra == 'fast'
Requires-Dist: uvloop<=0.22.1; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
Description-Content-Type: text/markdown

<p align="center">
    <a href="https://github.com/hypergram/hypergram">
        <img src="https://github.com/Shadowc89/Hypergram/blob/main/Hypergram.jpg" alt="hypergram" width="128">
    </a>
    <br>
    <b>Telegram MTProto API Framework for Python</b>
    <br>
    <a href="https://hypergram.icu">
        Homepage
    </a>
    •
    <a href="https://docs.hypergram.icu">
        Documentation
    </a>
    •
    <a href="https://t.me/hypergram_news">
        News
    </a>
    •
    <a href="https://t.me/hypergram_chat">
        Chat
    </a>
    

## hypergram

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

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

```python
from hypergram import Client, filters

app = Client("my_account")


@app.on_message(filters.private)
async def hello(client, message):
    await message.reply("Hello from hypergram!")


app.run()
```

**hypergram** is a modern, elegant and asynchronous [MTProto API](https://docs.hypergram.icu/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 hypergram with pip and start building your applications right away.
- **Easy**: Makes the Telegram API simple and intuitive, while still allowing advanced usages.
- **Elegant**: Low-level details are abstracted and re-presented in a more convenient way.
- **Type-hinted**: Types and methods are all type-hinted, enabling excellent editor support.
- **Async**: Fully asynchronous (also usable synchronously if wanted, for convenience).
- **Powerful**: Full access to Telegram's API to execute any official client action and more.

### Installing

Stable version

``` bash
pip install hypergram
```

Dev version

``` bash
pip install hypergram --force-reinstall
```

### Resources

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