Описание

Основные возможности

Установка

Important

Для работы библиотеки требуется Python 3.10 или выше

Установка через pip

pip install -U maxapi-python

Установка через uv

uv add -U maxapi-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())

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

Лицензия

Новости

Star History

Авторы

Контрибьюторы