Metadata-Version: 2.4
Name: beastx-python
Version: 1.0.2
Summary: A powerful Telegram client library inspired by Telethon
Home-page: https://github.com/msy1717/beastx-python
Author: BeastX Team
Author-email: info@beastx.dev
Maintainer: GodmrunaL
Maintainer-email: godmrunal@beastx.dev
Project-URL: Documentation, https://msy1717.github.io/beastx-python
Project-URL: Source, https://github.com/msy1717/beastx-python
Project-URL: Tracker, https://github.com/msy1717/beastx-python/issues
Project-URL: Telegram, https://t.me/GodmrunaL
Project-URL: Telethon, https://github.com/LonamiWebs/Telethon
Keywords: telegram,telegram-client,telegram-bot,telethon,mtproto,api
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: flask>=2.3.0
Requires-Dist: pyaes>=1.6.1
Provides-Extra: animation
Requires-Dist: tqdm>=4.65.0; extra == "animation"
Requires-Dist: colorama>=0.4.6; extra == "animation"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# BeastX - Powerful Telegram Client Library

BeastX is a modern, feature-rich Python library for interacting with Telegram's API.
Built with inspiration from Telethon, it provides an intuitive and powerful interface
for building Telegram bots and userbot applications.

## Features

- 🚀 **Easy to Use**: Simple, intuitive API similar to Telethon
- 🔄 **Async/Await**: Full async support for modern Python
- 📡 **Event Handlers**: Powerful event system for handling updates
- 💾 **Session Management**: Multiple session types (file, string, memory)
- 🔐 **Secure**: Built-in encryption and secure session storage
- 📦 **Auto Dependencies**: Automatically installs required packages

## Credits

BeastX is heavily inspired by [Telethon](https://github.com/LonamiWebs/Telethon)
by Lonami Exo. We thank the Telethon team for their excellent work and API design.

## Installation

```bash
pip install beastx-python
```

## Quick Start

```python
from beastx import TelegramClient, events

client = TelegramClient('session_name', api_id, api_hash)

@client.on(events.NewMessage(pattern='hello'))
async def handler(event):
    await event.reply('Hi there!')

client.start()
client.run_until_disconnected()
```

For more information, visit our documentation.
