Metadata-Version: 2.4
Name: tgram
Version: 2.0.4
Summary: Tgram is a user-friendly and lightweight Python library that simplifies interaction with the Telegram Bot API. It allows developers to easily create, manage, and automate Telegram bots.
License: MIT
License-File: LICENSE
Author: Zaid
Author-email: zaid@z44d.com
Requires-Python: >=3.10
Classifier: License :: OSI Approved :: MIT License
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
Requires-Dist: aiohttp (>=3.10.11)
Requires-Dist: certifi (>=2024.12.14)
Description-Content-Type: text/markdown

<div align="center"> <h1>Tgram<h1> <h3>A developer-friendly Telegram Bot API library designed for Python enthusiasts. <br> <a href="https://t.me/tgbot_channel">Channel</a> • <a href="https://z44d.github.io/tgram/">Documentation</a> • <a href="https://github.com/z44d/tgram/tree/main/examples">Examples</a></h3> </div>



<div align="center"> <a href="https://core.telegram.org/bots/api#december-31-2025"> <img src="https://img.shields.io/badge/Bot%20API-9.3-blue?logo=telegram" alt="Supported Bot API version"> </a> <a href="https://pypi.org/project/tgram/"> <img src="https://img.shields.io/pypi/v/tgram.svg?logo=python&logoColor=%23959DA5&label=pypi&labelColor=%23282f37" alt="PyPI"> </a> <a href="https://pepy.tech/project/tgram"> <img src="https://static.pepy.tech/badge/tgram" alt="Downloads"> </a> <a href="https://t.me/tgbot_channel"> <img src="https://img.shields.io/badge/Telegram-Channel-blue.svg?logo=telegram" alt="Telegram Channel"> </a> <a href="https://t.me/tgbot_chat"> <img src="https://img.shields.io/badge/Telegram-Group-blue.svg?logo=telegram" alt="Telegram Group"> </a> </div>

## 🚀 Quick Start

Here's a basic example to get started with tgram:

```python
import asyncio
from tgram import TgBot, filters
from tgram.types import Message

bot = TgBot("YOUR_BOT_TOKEN")

@bot.on_message(filters.text & filters.private)
async def on_message(bot: TgBot, message: Message) -> Message:
    # Echo the incoming message
    return await message.reply_text(
        message.text,
        entities=message.entities
    )

asyncio.run(bot.run())
```

## 📦 Features

- **Smart Plugins**: Auto-loadable plugins for modular development.
- **Filters for Handlers**: Simplify event handling with filters.
- **Bound Methods**: Access bound methods for different update types easily.

## 📚 Documentation

Full documentation is available [here](https://z44d.github.io/tgram/).

## 🔧 Installation

You can install the tgram library using one of the following methods:

### Via git:

```bash
pip install git+https://github.com/z44d/tgram -U
```

### Via PyPI (Recommended)

```bash
pip install tgram -U
```

## 💡 Requirements

- **Python**: Version 3.8 or higher.
- **Telegram Bot Token**: Obtain one by following [this guide](https://core.telegram.org/bots/tutorial#obtain-your-bot-token).

## 💬 Help & Support

- For general questions and help, join our **[Telegram chat](https://t.me/tgbot_chat)**.
- Follow updates via the **[Telegram Channel](https://t.me/tgbot_channel)**.

