Metadata-Version: 2.4
Name: cobaltgram
Version: 0.1.0
Summary: Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots
Project-URL: Source, https://github.com/cobaltgram/cobaltgram
Project-URL: Issues, https://github.com/cobaltgram/cobaltgram/issues
Author: cobaltgram
Maintainer: cobaltgram
License-Expression: LGPL-3.0-or-later
License-File: COPYING
License-File: COPYING.lesser
Keywords: api,chat,client,library,messenger,mtproto,python,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 :: 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.16.2; extra == 'dev'
Requires-Dist: keyring<=25.7.0; extra == 'dev'
Requires-Dist: pytest-asyncio<=1.3.0; extra == 'dev'
Requires-Dist: pytest-cov<=7.0.0; extra == 'dev'
Requires-Dist: pytest<=9.0.2; extra == 'dev'
Requires-Dist: twine<=6.2.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: pygments<=2.19.2; extra == 'docs'
Requires-Dist: shibuya<=2026.1.9; 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.21.0; (sys_platform == 'darwin' or sys_platform == 'linux') and extra == 'fast'
Description-Content-Type: text/markdown

<p align="center">
    <b>Telegram MTProto API Framework for Python</b>
</p>

## CobaltGram

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

``` python
from cobaltgram import Client, filters

app = Client("my_account")


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


app.run()
```

**CobaltGram** is a modern, elegant and asynchronous [MTProto API](https://core.telegram.org/mtproto)
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 CobaltGram 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.
- **Fast**: Boosted up by [TgCrypto](https://github.com/cobaltgram/tgcrypto), a high-performance cryptography library written in C.
- **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
pip3 install cobaltgram
```

Dev version
``` bash
pip3 install https://github.com/cobaltgram/cobaltgram/archive/dev.zip --force-reinstall
```

### Resources

- Check out the [Telegram Bot API docs](https://core.telegram.org/bots/api) to learn more about what's possible.
- Check out the [Telegram API docs](https://core.telegram.org/api) for low-level MTProto details.
