maxapi


Namemaxapi JSON
Version 0.9.1 PyPI version JSON
download
home_pageNone
SummaryБиблиотека для разработки чат-ботов с помощью API мессенджера MAX
upload_time2025-07-20 19:55:43
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords max api bot
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Асинхронный MAX API

[![PyPI version](https://img.shields.io/pypi/v/maxapi.svg)](https://pypi.org/project/maxapi/)
[![Python Version](https://img.shields.io/pypi/pyversions/maxapi.svg)](https://pypi.org/project/maxapi/)
[![License](https://img.shields.io/github/license/love-apples/maxapi.svg)](https://love-apples/maxapi/blob/main/LICENSE)

---

## 📦 Установка

```bash
pip install maxapi
```

---

## 🚀 Быстрый старт

Если вы тестируете бота в чате - не забудьте дать ему права администратора!

```python
import asyncio
import logging

from maxapi import Bot, Dispatcher
from maxapi.types import BotStarted, Command, MessageCreated

logging.basicConfig(level=logging.INFO)

bot = Bot('тут_ваш_токен')
dp = Dispatcher()


@dp.bot_started()
async def bot_started(event: BotStarted):
    await event.bot.send_message(
        chat_id=event.chat_id,
        text='Привет! Отправь мне /start'
    )


@dp.message_created(Command('start'))
async def hello(event: MessageCreated):
    await event.message.answer(f"Пример чат-бота для MAX 💙")


async def main():
    await dp.start_polling(bot)


if __name__ == '__main__':
    asyncio.run(main())
```

---

## 📚 Документация

[Тут](https://github.com/love-apples/maxapi/wiki)

---

## ⭐️ Примеры

[Тут](https://github.com/love-apples/maxapi/tree/main/examples)

---


## 🧩 Возможности

- ✅ Middleware
- ✅ Роутеры
- ✅ Билдер инлайн клавиатур
- ✅ Простая загрузка медиафайлов
- ✅ MagicFilter
- ✅ Внутренние функции моделей
- ✅ Контекстный менеджер
- ✅ Поллинг
- ✅ Вебхук
- ✅ Логгирование

---


## 💬 Обратная связь и поддержка

- MAX: [Чат](https://max.ru/join/IPAok63C3vFqbWTFdutMUtjmrAkGqO56YeAN7iyDfc8)
- Telegram: [@loveappless](https://t.me/loveappless)
- Telegram чат: [MAXApi | Обсуждение](https://t.me/maxapi_github)
---

## 📄 Лицензия

Этот проект распространяется под лицензией MIT. См. файл [LICENSE](https://github.com/love-apples/maxapi/blob/main/LICENSE) для подробностей.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "maxapi",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "max, api, bot",
    "author": null,
    "author_email": "Denis <bestloveapples@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/a5/9b/844a0baf65eb55897100372e666ba2f7298a914bfe15a38c58d39a1550a0/maxapi-0.9.1.tar.gz",
    "platform": null,
    "description": "# \u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0439 MAX API\r\n\r\n[![PyPI version](https://img.shields.io/pypi/v/maxapi.svg)](https://pypi.org/project/maxapi/)\r\n[![Python Version](https://img.shields.io/pypi/pyversions/maxapi.svg)](https://pypi.org/project/maxapi/)\r\n[![License](https://img.shields.io/github/license/love-apples/maxapi.svg)](https://love-apples/maxapi/blob/main/LICENSE)\r\n\r\n---\r\n\r\n## \ud83d\udce6 \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\r\n\r\n```bash\r\npip install maxapi\r\n```\r\n\r\n---\r\n\r\n## \ud83d\ude80 \u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u0441\u0442\u0430\u0440\u0442\r\n\r\n\u0415\u0441\u043b\u0438 \u0432\u044b \u0442\u0435\u0441\u0442\u0438\u0440\u0443\u0435\u0442\u0435 \u0431\u043e\u0442\u0430 \u0432 \u0447\u0430\u0442\u0435 - \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c\u0442\u0435 \u0434\u0430\u0442\u044c \u0435\u043c\u0443 \u043f\u0440\u0430\u0432\u0430 \u0430\u0434\u043c\u0438\u043d\u0438\u0441\u0442\u0440\u0430\u0442\u043e\u0440\u0430!\r\n\r\n```python\r\nimport asyncio\r\nimport logging\r\n\r\nfrom maxapi import Bot, Dispatcher\r\nfrom maxapi.types import BotStarted, Command, MessageCreated\r\n\r\nlogging.basicConfig(level=logging.INFO)\r\n\r\nbot = Bot('\u0442\u0443\u0442_\u0432\u0430\u0448_\u0442\u043e\u043a\u0435\u043d')\r\ndp = Dispatcher()\r\n\r\n\r\n@dp.bot_started()\r\nasync def bot_started(event: BotStarted):\r\n    await event.bot.send_message(\r\n        chat_id=event.chat_id,\r\n        text='\u041f\u0440\u0438\u0432\u0435\u0442! \u041e\u0442\u043f\u0440\u0430\u0432\u044c \u043c\u043d\u0435 /start'\r\n    )\r\n\r\n\r\n@dp.message_created(Command('start'))\r\nasync def hello(event: MessageCreated):\r\n    await event.message.answer(f\"\u041f\u0440\u0438\u043c\u0435\u0440 \u0447\u0430\u0442-\u0431\u043e\u0442\u0430 \u0434\u043b\u044f MAX \ud83d\udc99\")\r\n\r\n\r\nasync def main():\r\n    await dp.start_polling(bot)\r\n\r\n\r\nif __name__ == '__main__':\r\n    asyncio.run(main())\r\n```\r\n\r\n---\r\n\r\n## \ud83d\udcda \u0414\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f\r\n\r\n[\u0422\u0443\u0442](https://github.com/love-apples/maxapi/wiki)\r\n\r\n---\r\n\r\n## \u2b50\ufe0f \u041f\u0440\u0438\u043c\u0435\u0440\u044b\r\n\r\n[\u0422\u0443\u0442](https://github.com/love-apples/maxapi/tree/main/examples)\r\n\r\n---\r\n\r\n\r\n## \ud83e\udde9 \u0412\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438\r\n\r\n- \u2705 Middleware\r\n- \u2705 \u0420\u043e\u0443\u0442\u0435\u0440\u044b\r\n- \u2705 \u0411\u0438\u043b\u0434\u0435\u0440 \u0438\u043d\u043b\u0430\u0439\u043d \u043a\u043b\u0430\u0432\u0438\u0430\u0442\u0443\u0440\r\n- \u2705 \u041f\u0440\u043e\u0441\u0442\u0430\u044f \u0437\u0430\u0433\u0440\u0443\u0437\u043a\u0430 \u043c\u0435\u0434\u0438\u0430\u0444\u0430\u0439\u043b\u043e\u0432\r\n- \u2705 MagicFilter\r\n- \u2705 \u0412\u043d\u0443\u0442\u0440\u0435\u043d\u043d\u0438\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438 \u043c\u043e\u0434\u0435\u043b\u0435\u0439\r\n- \u2705 \u041a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u043d\u044b\u0439 \u043c\u0435\u043d\u0435\u0434\u0436\u0435\u0440\r\n- \u2705 \u041f\u043e\u043b\u043b\u0438\u043d\u0433\r\n- \u2705 \u0412\u0435\u0431\u0445\u0443\u043a\r\n- \u2705 \u041b\u043e\u0433\u0433\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435\r\n\r\n---\r\n\r\n\r\n## \ud83d\udcac \u041e\u0431\u0440\u0430\u0442\u043d\u0430\u044f \u0441\u0432\u044f\u0437\u044c \u0438 \u043f\u043e\u0434\u0434\u0435\u0440\u0436\u043a\u0430\r\n\r\n- MAX: [\u0427\u0430\u0442](https://max.ru/join/IPAok63C3vFqbWTFdutMUtjmrAkGqO56YeAN7iyDfc8)\r\n- Telegram: [@loveappless](https://t.me/loveappless)\r\n- Telegram \u0447\u0430\u0442: [MAXApi | \u041e\u0431\u0441\u0443\u0436\u0434\u0435\u043d\u0438\u0435](https://t.me/maxapi_github)\r\n---\r\n\r\n## \ud83d\udcc4 \u041b\u0438\u0446\u0435\u043d\u0437\u0438\u044f\r\n\r\n\u042d\u0442\u043e\u0442 \u043f\u0440\u043e\u0435\u043a\u0442 \u0440\u0430\u0441\u043f\u0440\u043e\u0441\u0442\u0440\u0430\u043d\u044f\u0435\u0442\u0441\u044f \u043f\u043e\u0434 \u043b\u0438\u0446\u0435\u043d\u0437\u0438\u0435\u0439 MIT. \u0421\u043c. \u0444\u0430\u0439\u043b [LICENSE](https://github.com/love-apples/maxapi/blob/main/LICENSE) \u0434\u043b\u044f \u043f\u043e\u0434\u0440\u043e\u0431\u043d\u043e\u0441\u0442\u0435\u0439.\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "\u0411\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u0434\u043b\u044f \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438 \u0447\u0430\u0442-\u0431\u043e\u0442\u043e\u0432 \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e API \u043c\u0435\u0441\u0441\u0435\u043d\u0434\u0436\u0435\u0440\u0430 MAX",
    "version": "0.9.1",
    "project_urls": {
        "Homepage": "https://github.com/love-apples/maxapi"
    },
    "split_keywords": [
        "max",
        " api",
        " bot"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8fa88df66aa1a1d8aa81f20b0c03f884d9db3c7fe8143bc29f39b3f32bb31e30",
                "md5": "d75b407cf73c390b6d9befd49256dac4",
                "sha256": "2e6ae972797977c89eabe3fb6fa90753965093590abd820ead715832e96b3669"
            },
            "downloads": -1,
            "filename": "maxapi-0.9.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d75b407cf73c390b6d9befd49256dac4",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 101966,
            "upload_time": "2025-07-20T19:55:42",
            "upload_time_iso_8601": "2025-07-20T19:55:42.153886Z",
            "url": "https://files.pythonhosted.org/packages/8f/a8/8df66aa1a1d8aa81f20b0c03f884d9db3c7fe8143bc29f39b3f32bb31e30/maxapi-0.9.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a59b844a0baf65eb55897100372e666ba2f7298a914bfe15a38c58d39a1550a0",
                "md5": "936ee91bf1fd120017bdca8f8ff0c739",
                "sha256": "fd4f9725ea180fc0b5f03ccb6d7e8193282b41422a70f402f3e0b43c4a636d5f"
            },
            "downloads": -1,
            "filename": "maxapi-0.9.1.tar.gz",
            "has_sig": false,
            "md5_digest": "936ee91bf1fd120017bdca8f8ff0c739",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 48868,
            "upload_time": "2025-07-20T19:55:43",
            "upload_time_iso_8601": "2025-07-20T19:55:43.700643Z",
            "url": "https://files.pythonhosted.org/packages/a5/9b/844a0baf65eb55897100372e666ba2f7298a914bfe15a38c58d39a1550a0/maxapi-0.9.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-20 19:55:43",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "love-apples",
    "github_project": "maxapi",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "maxapi"
}
        
Elapsed time: 0.74561s