| Name | Hydrogram JSON |
| Version |
0.1.4
JSON |
| download |
| home_page | |
| Summary | Sleek, advanced, and asynchronous Telegram MTProto API framework in Python, designed for fluid user and bot interactions. |
| upload_time | 2023-12-04 17:52:25 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | |
| keywords |
telegram
chat
messenger
mtproto
api
client
library
python
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<a href="https://github.com/AmanoTeam/hydrogram">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/AmanoTeam/hydrogram/main/docs/source/_static/hydrogram-dark.png">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/AmanoTeam/hydrogram/main/docs/source/_static/hydrogram-light.png">
<img alt="Hydrogram" width="128" src="https://raw.githubusercontent.com/AmanoTeam/hydrogram/main/docs/source/_static/hydrogram-light.png">
</picture>
</a>
<br>
<b>Python Framework for the Telegram MTProto API</b>
<br>
<a href="https://hydrogram.amanoteam.com">
Homepage
</a>
•
<a href="https://hydrogram.amanoteam.com/docs">
Documentation
</a>
•
<a href="https://hydrogram.amanoteam.com/docs/releases">
Releases
</a>
•
<a href="https://t.me/HydrogramNews">
News
</a>
</p>
# Hydrogram
[](https://github.com/astral-sh/ruff)
[](https://pypi.python.org/pypi/hydrogram)
[](https://pypi.python.org/pypi/hydrogram)
[](https://pypi.python.org/pypi/hydrogram)
[](https://pypi.python.org/pypi/hydrogram/)
[](https://github.com/AmanoTeam/hydrogram/actions)
## Description
Hydrogram is a Python library for interacting with the Telegram MTProto API. It provides a simple and intuitive interface for developers to leverage the power of Telegram's API in their Python applications.
## Installation
To install Hydrogram, you need Python 3 installed on your system. If you don't have Python installed, you can download it from the official website.
To install Hydrogram, use pip:
```bash
pip install hydrogram -U
```
## Usage
Here is a basic example of how to use Hydrogram:
```python
from hydrogram import Client, filters
app = Client("my_account")
@app.on_message(filters.private)
async def hello(client, message):
await message.reply("Hello from Hydrogram!")
app.run()
```
## Features
- **Easy to use:** Hydrogram provides a simple and intuitive interface for developers to leverage the power of Telegram's API in their Python applications, while still allowing advanced usages.
- **Elegant:** Low-level details are abstracted and re-presented in a more convenient way, making the Telegram API more accessible.
- **Fast:** Hydrogram is boosted by [TgCrypto](https://github.com/pyrogram/tgcrypto), a high-performance cryptography library written in C, which makes it faster than other Python Telegram libraries.
- **Type-hinted:** Types and methods are all type-hinted, enabling excellent editor support and making it easier to write and maintain code.
- **Async:** Hydrogram is fully asynchronous, which means it can handle multiple requests at the same time, making it faster and more efficient (also usable synchronously if wanted, for convenience).
- **Powerful:** Hydrogram provides full access to Telegram's API to execute any official client action and more, giving developers the flexibility to build powerful applications.
## Resources
- The [documentation](https://hydrogram.amanoteam.com/docs) is the technical reference for Hydrogram. It includes detailed usage guides, API reference, and more.
- The [homepage](https://hydrogram.amanoteam.com) is the official website for Hydrogram. It includes a quickstart guide, a list of features, and more.
- Our [Telegram channel](https://t.me/HydrogramNews) is where we post news and updates about Hydrogram.
## Contributing
Hydrogram is an open source project and we welcome contributions from the community. We appreciate all types of contributions, including bug reports, feature requests, documentation improvements, and code contributions.
To get started, please review our [contribution guidelines](https://github.com/AmanoTeam/hydrogram/blob/main/CONTRIBUTING.rst) for more information. You can also help by [reporting bugs or feature requests](https://github.com/AmanoTeam/hydrogram/issues/new/choose).
If you're interested in contributing code, you'll need to set up the development environment. Here are the steps:
1. Clone the repository: `git clone https://github.com/AmanoTeam/hydrogram.git`
2. Install the dependencies: `pip install .[dev]`
3. Run the tests: `pytest`
4. Make your changes and submit a pull request.
All contributors are expected to adhere to the [Code of Conduct](https://github.com/AmanoTeam/hydrogram/blob/main/CODE_OF_CONDUCT.rst). Please read it before contributing.
We appreciate your help in making Hydrogram better!
## Support
Hydrogram is an open source project. Your support helps us maintain and improve the library. You can support the development of Hydrogram through the following platforms:
- [Liberapay](https://liberapay.com/hydrogram)
- [OpenCollective](https://opencollective.com/hydrogram)
## Thanks
- [Pyrogram](https://github.com/pyrogram/pyrogram) and its contributors for the inspiration and base code.
## License
You may copy, distribute and modify the software provided that modifications are described and licensed for free under [LGPL-3](https://www.gnu.org/licenses/lgpl-3.0.html). Derivatives works (including modifications or anything statically linked to the library) can only be redistributed under LGPL-3, but applications that use the library don't have to be.
Raw data
{
"_id": null,
"home_page": "",
"name": "Hydrogram",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "telegram chat messenger mtproto api client library python",
"author": "",
"author_email": "Amano LLC <contact@amanoteam.com>",
"download_url": "https://files.pythonhosted.org/packages/40/75/85682e00daf2a2e4f1980f57ac31c6aa34b102fd8875f1bf994e57622004/hydrogram-0.1.4.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://github.com/AmanoTeam/hydrogram\">\n <picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/AmanoTeam/hydrogram/main/docs/source/_static/hydrogram-dark.png\">\n <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/AmanoTeam/hydrogram/main/docs/source/_static/hydrogram-light.png\">\n <img alt=\"Hydrogram\" width=\"128\" src=\"https://raw.githubusercontent.com/AmanoTeam/hydrogram/main/docs/source/_static/hydrogram-light.png\">\n </picture>\n </a>\n <br>\n <b>Python Framework for the Telegram MTProto API</b>\n <br>\n <a href=\"https://hydrogram.amanoteam.com\">\n Homepage\n </a>\n \u2022\n <a href=\"https://hydrogram.amanoteam.com/docs\">\n Documentation\n </a>\n \u2022\n <a href=\"https://hydrogram.amanoteam.com/docs/releases\">\n Releases\n </a>\n \u2022\n <a href=\"https://t.me/HydrogramNews\">\n News\n </a>\n</p>\n\n# Hydrogram\n\n[](https://github.com/astral-sh/ruff)\n[](https://pypi.python.org/pypi/hydrogram)\n[](https://pypi.python.org/pypi/hydrogram)\n[](https://pypi.python.org/pypi/hydrogram)\n[](https://pypi.python.org/pypi/hydrogram/)\n[](https://github.com/AmanoTeam/hydrogram/actions)\n\n## Description\n\nHydrogram is a Python library for interacting with the Telegram MTProto API. It provides a simple and intuitive interface for developers to leverage the power of Telegram's API in their Python applications.\n\n## Installation\n\nTo install Hydrogram, you need Python 3 installed on your system. If you don't have Python installed, you can download it from the official website.\n\nTo install Hydrogram, use pip:\n\n```bash\npip install hydrogram -U\n```\n\n## Usage\n\nHere is a basic example of how to use Hydrogram:\n\n```python\nfrom hydrogram import Client, filters\n\napp = Client(\"my_account\")\n\n\n@app.on_message(filters.private)\nasync def hello(client, message):\n await message.reply(\"Hello from Hydrogram!\")\n\n\napp.run()\n```\n\n## Features\n\n- **Easy to use:** Hydrogram provides a simple and intuitive interface for developers to leverage the power of Telegram's API in their Python applications, while still allowing advanced usages.\n- **Elegant:** Low-level details are abstracted and re-presented in a more convenient way, making the Telegram API more accessible.\n- **Fast:** Hydrogram is boosted by [TgCrypto](https://github.com/pyrogram/tgcrypto), a high-performance cryptography library written in C, which makes it faster than other Python Telegram libraries.\n- **Type-hinted:** Types and methods are all type-hinted, enabling excellent editor support and making it easier to write and maintain code.\n- **Async:** Hydrogram is fully asynchronous, which means it can handle multiple requests at the same time, making it faster and more efficient (also usable synchronously if wanted, for convenience).\n- **Powerful:** Hydrogram provides full access to Telegram's API to execute any official client action and more, giving developers the flexibility to build powerful applications.\n\n## Resources\n\n- The [documentation](https://hydrogram.amanoteam.com/docs) is the technical reference for Hydrogram. It includes detailed usage guides, API reference, and more.\n- The [homepage](https://hydrogram.amanoteam.com) is the official website for Hydrogram. It includes a quickstart guide, a list of features, and more.\n- Our [Telegram channel](https://t.me/HydrogramNews) is where we post news and updates about Hydrogram.\n\n## Contributing\n\nHydrogram is an open source project and we welcome contributions from the community. We appreciate all types of contributions, including bug reports, feature requests, documentation improvements, and code contributions.\n\nTo get started, please review our [contribution guidelines](https://github.com/AmanoTeam/hydrogram/blob/main/CONTRIBUTING.rst) for more information. You can also help by [reporting bugs or feature requests](https://github.com/AmanoTeam/hydrogram/issues/new/choose).\n\nIf you're interested in contributing code, you'll need to set up the development environment. Here are the steps:\n\n1. Clone the repository: `git clone https://github.com/AmanoTeam/hydrogram.git`\n2. Install the dependencies: `pip install .[dev]`\n3. Run the tests: `pytest`\n4. Make your changes and submit a pull request.\n\nAll contributors are expected to adhere to the [Code of Conduct](https://github.com/AmanoTeam/hydrogram/blob/main/CODE_OF_CONDUCT.rst). Please read it before contributing.\n\nWe appreciate your help in making Hydrogram better!\n\n## Support\n\nHydrogram is an open source project. Your support helps us maintain and improve the library. You can support the development of Hydrogram through the following platforms:\n\n- [Liberapay](https://liberapay.com/hydrogram)\n- [OpenCollective](https://opencollective.com/hydrogram)\n\n## Thanks\n\n- [Pyrogram](https://github.com/pyrogram/pyrogram) and its contributors for the inspiration and base code.\n\n## License\n\nYou may copy, distribute and modify the software provided that modifications are described and licensed for free under [LGPL-3](https://www.gnu.org/licenses/lgpl-3.0.html). Derivatives works (including modifications or anything statically linked to the library) can only be redistributed under LGPL-3, but applications that use the library don't have to be.\n",
"bugtrack_url": null,
"license": "",
"summary": "Sleek, advanced, and asynchronous Telegram MTProto API framework in Python, designed for fluid user and bot interactions.",
"version": "0.1.4",
"project_urls": {
"Community": "https://t.me/HydrogramNews",
"Documentation": "https://hydrogram.amanoteam.com",
"Source": "https://github.com/AmanoTeam/Hydrogram",
"Tracker": "https://github.com/AmanoTeam/Hydrogram/issues"
},
"split_keywords": [
"telegram",
"chat",
"messenger",
"mtproto",
"api",
"client",
"library",
"python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3f8bf401f73b102201f2c19843d3343a9616eadd2ac64beadd233b93c66c8d5b",
"md5": "e507575711eda38da86b037dc07917f4",
"sha256": "d561495c1f1147e2a9dea33cd53c7fa0a2fb151d75a14a3cf9d3a85868c3e830"
},
"downloads": -1,
"filename": "hydrogram-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e507575711eda38da86b037dc07917f4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3804378,
"upload_time": "2023-12-04T17:52:23",
"upload_time_iso_8601": "2023-12-04T17:52:23.515747Z",
"url": "https://files.pythonhosted.org/packages/3f/8b/f401f73b102201f2c19843d3343a9616eadd2ac64beadd233b93c66c8d5b/hydrogram-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "407585682e00daf2a2e4f1980f57ac31c6aa34b102fd8875f1bf994e57622004",
"md5": "d3f77f2c28e2601a0616f59d34ad7681",
"sha256": "8de57f8cd19767932951562e4ad14e25e7a2308644c0b5bd0dfb75ad4f62b1b4"
},
"downloads": -1,
"filename": "hydrogram-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "d3f77f2c28e2601a0616f59d34ad7681",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 346738,
"upload_time": "2023-12-04T17:52:25",
"upload_time_iso_8601": "2023-12-04T17:52:25.251440Z",
"url": "https://files.pythonhosted.org/packages/40/75/85682e00daf2a2e4f1980f57ac31c6aa34b102fd8875f1bf994e57622004/hydrogram-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-04 17:52:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AmanoTeam",
"github_project": "Hydrogram",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "hydrogram"
}
