Metadata-Version: 2.4
Name: Qelagram
Version: 2.0.106
Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
Home-page: https://github.com/qelagram
Download-URL: https://github.com/qelagram/qelagram/releases/latest
Author: Dan
Author-email: dan@qelagram.org
Maintainer: qelaro.in, Souvik Nandi
Maintainer-email: contact@qelaro.in
License: LGPLv3
Project-URL: Tracker, https://github.com/qelagram/qelagram/issues
Project-URL: Community, https://t.me/qelagram
Project-URL: Source, https://github.com/qelagram/qelagram
Project-URL: Documentation, https://docs.qelagram.org
Keywords: telegram chat messenger mtproto api client library python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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 :: Implementation
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet
Classifier: Topic :: Communications
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: ~=3.7
Description-Content-Type: text/markdown
License-File: COPYING
License-File: COPYING.lesser
License-File: NOTICE
Requires-Dist: pyaes==1.6.1
Requires-Dist: pysocks==1.7.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<p align="center">
    <a href="https://github.com/qelagram/qelagram">
        <img src="https://raw.githubusercontent.com/qelagram/artwork/master/artwork/qelagram-logo.png" alt="Qelagram Logo" width="160">
    </a>
    <h1 align="center">Qelagram</h1>
    <p align="center">
        <b>An elegant, modern, and asynchronous Telegram MTProto API framework in Python.</b>
    </p>
</p>

<p align="center">
    <a href="https://pypi.org/project/qelagram/"><img src="https://img.shields.io/pypi/v/qelagram?color=blue&style=flat-square" alt="PyPI version"></a>
    <a href="https://pypi.org/project/qelagram/"><img src="https://img.shields.io/pypi/pyversions/qelagram?style=flat-square" alt="Python Versions"></a>
    <a href="https://github.com/qelagram/qelagram/blob/master/LICENSE"><img src="https://img.shields.io/github/license/qelagram/qelagram?color=orange&style=flat-square" alt="License"></a>
    <a href="https://t.me/qelagram"><img src="https://img.shields.io/badge/telegram-channel-blue.svg?color=0088cc&style=flat-square" alt="Telegram Channel"></a>
</p>

---

**Qelagram** is a high-performance Telegram MTProto API framework designed for Python developers who value elegance and efficiency. It enables seamless interaction with the Telegram network using user accounts (custom clients) or bot identities.

Developed and maintained by **[Qelaro](https://qelaro.in)** and **Souvik Nandi**, Qelagram offers a premium developer experience with full type hints, modern asyncio design, and robust fallback layers.

## 🚀 Key Features

*   ⚡ **Fully Asynchronous:** Native `asyncio` implementation for high-concurrency event loops.
*   💎 **Elegant & Clean:** Complicated MTProto structures are abstracted into intuitive, developer-friendly methods.
*   🏎️ **Optimized Cryptography:** Speed is boosted by **TgCrypto**, a native C extension for ultra-fast AES and SHA calculations.
*   🎯 **Full Type-Safety:** Fully type-hinted methods and objects, providing rich IDE auto-completion and static analysis.
*   🛠️ **Powerful Client:** Execute low-level MTProto queries using raw invokes, alongside high-level abstractions.

---

## 📦 Installation

Install Qelagram easily via `pip`:

```bash
pip install -U qelagram
```

### ⚡ Boost Performance (Optional)

To enable hardware-accelerated cryptographic routines, compile and install `tgcrypto`:

```bash
pip install tgcrypto
```

---

## 💻 Quick Start

Create a client session and listen for private messages:

```python
from qelagram import Client, filters

# Initialize client (saves session to my_account.session)
app = Client("my_account")

@app.on_message(filters.private & filters.text)
async def reply_handler(client, message):
    # Respond to incoming private text messages
    await message.reply("Hello from Qelagram!")

# Start the client event loop
app.run()
```

When running the script for the first time, you will be prompted via the terminal to input your credentials (phone number and Telegram login code).

---

## 📚 Resources

*   📖 **Official Website:** [qelaro.in](https://qelaro.in)
*   📝 **Guides & API Documentation:** [Docs](https://docs.qelagram.org)
*   📢 **News & Updates Channel:** [@qelagram](https://t.me/qelagram)

---

## ⚖️ License & Copyright

*   **License:** GNU Lesser General Public License v3 or later (LGPLv3+)
*   **Copyright:** © 2025-present [qelaro.in](https://qelaro.in) and Souvik Nandi. All rights reserved.
