https://github.com/ink-developer/pymax
Асинхронный Python-враппер для работы с внутренним API MAX Manager (Userbot). Упрощает автоматизацию и интеграцию.
https://github.com/ink-developer/pymax
api max max-api-selfbot max-api-userbot max-messenger maxapi-python pymax python selfbot userbot vk vkontakte websockets
Last synced: about 2 months ago
JSON representation
Асинхронный Python-враппер для работы с внутренним API MAX Manager (Userbot). Упрощает автоматизацию и интеграцию.
- Host: GitHub
- URL: https://github.com/ink-developer/pymax
- Owner: ink-developer
- License: mit
- Created: 2025-08-20T12:05:40.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-10-09T13:42:59.000Z (about 2 months ago)
- Last Synced: 2025-10-10T21:49:06.025Z (about 2 months ago)
- Topics: api, max, max-api-selfbot, max-api-userbot, max-messenger, maxapi-python, pymax, python, selfbot, userbot, vk, vkontakte, websockets
- Language: Python
- Homepage:
- Size: 158 KB
- Stars: 32
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Python wrapper для API мессенджера Max
---
> ⚠️ **Дисклеймер**
>
> * Это **неофициальная** библиотека для работы с внутренним API Max.
> * Использование может **нарушать условия предоставления услуг** сервиса.
> * **Вы используете её исключительно на свой страх и риск.**
> * **Разработчики и контрибьюторы не несут никакой ответственности** за любые последствия использования этого пакета, включая, но не ограничиваясь: блокировку аккаунтов, утерю данных, юридические риски и любые другие проблемы.
> * API может быть изменен в любой момент без предупреждения.
---
## Описание
**`pymax`** — асинхронная Python библиотека для работы с API мессенджера Max. Предоставляет интерфейс для отправки сообщений, управления чатами, каналами и диалогами через WebSocket соединение.
### Основные возможности
- Вход по номеру телефона
- Отправка, редактирование и удаление сообщений
- Работа с чатами и каналами
- История сообщений
## Установка
> [!IMPORTANT]
> Для работы библиотеки требуется Python 3.10 или выше
### Установка через pip
```bash
pip install -U maxapi-python
```
### Установка через uv
```bash
uv add -U maxapi-python
```
## Быстрый старт
### Базовый пример использования
```python
import asyncio
from pymax import MaxClient, Message
# Инициализация клиента
phone = "+1234567890"
client = MaxClient(phone=phone, work_dir="cache")
# Обработчик входящих сообщений
@client.on_message()
async def handle_message(message: Message) -> None:
print(f"{message.sender}: {message.text}")
# Обработчик запуска клиента
@client.on_start
async def handle_start() -> None:
print("Клиент запущен")
# Получение истории сообщений
history = await client.fetch_history(chat_id=0)
if history:
for message in history:
user = await client.get_user(message.sender)
if user:
print(f"{user.names[0].name}: {message.text}")
async def main() -> None:
await client.start()
# Работа с чатами
for chat in client.chats:
print(f"Чат: {chat.title}")
# Отправка сообщения
message = await client.send_message(
"Привет от PyMax!",
chat.id,
notify=True
)
# Редактирование сообщения
await asyncio.sleep(2)
await client.edit_message(
chat.id,
message.id,
"Привет от PyMax! (отредактировано)"
)
# Удаление сообщения
await asyncio.sleep(2)
await client.delete_message(chat.id, [message.id], for_me=False)
# Работа с диалогами
for dialog in client.dialogs:
print(f"Диалог: {dialog.last_message.text}")
# Работа с каналами
for channel in client.channels:
print(f"Канал: {channel.title}")
await client.close()
if __name__ == "__main__":
asyncio.run(main())
```
## Документация
[WIP](https://noxzion.github.io/)
## Лицензия
Этот проект распространяется под лицензией MIT. См. файл [LICENSE](LICENSE) для получения информации.
## Новости
[Telegram](https://t.me/pymax_news)
## Авторы
- **[noxzion](https://github.com/noxzion)** — оригинальный автор проекта
- **[ink](https://github.com/ink-developer)** — второй разработчик, исследование API и его документация
- **[fresh-milkshake](https://github.com/fresh-milkshake)** — контрибьютор и автор лого