Qelagram 2.0.106

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

Qelagram

An elegant, modern, and asynchronous Telegram MTProto API framework in Python.

---

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 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:

pip install -U qelagram

⚡ Boost Performance (Optional)

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

pip install tgcrypto

---

💻 Quick Start

Create a client session and listen for private messages:

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
• 📝 Guides & API Documentation: Docs
• 📢 News & Updates Channel: @qelagram

---

⚖️ License & Copyright

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