⚡️ Первый и лучший UserBot для мессенджера Max с удобной и гибкой системой модулей.
Создан YouRooni с ❤️
Maxli — это новаторский UserBot для мессенджера Max, разработанный для автоматизации рутинных действий и расширения стандартного функционала. Это первый в своем роде юзербот для данной платформы, предлагающий пользователям непревзойденные возможности.
Проект работает на Python и использует библиотеку PyMax (maxapi-python) для взаимодействия с API мессенджера Max. Благодаря своей архитектуре, Maxli легко запускается как на VDS/VPS, так и на локальной машине, а его система плагинов обеспечивает простую кастомизацию и расширение.
- 🤖 Автоматизация: Настраивайте автоматические ответы, команды и сценарии
- 🧩 Гибкая система модулей: Расширяйте функционал с помощью готовых плагинов или создавайте свои
- 💬 Поддержка чатов: Стабильная работа в личных сообщениях и групповых чатах
- 🚀 Простая установка: Готовые скрипты для быстрой установки на Windows и Linux
- ⚙️ Удобная настройка: Конфигурация через простые и понятные файлы
Все актуальные новости, обновления и полезную информацию о проекте вы найдете в нашем официальном Telegram-канале.
➡️ Подписаться на канал: UserbotMax.t.me
Перед установкой убедитесь, что у вас установлено:
| Требование | Минимальная версия | Как проверить |
|---|---|---|
| Python | 3.12+ | python --version |
| pip | Любая | pip --version |
| Git | Любая | git --version |
🖥️ Windows
- Скачайте Python с официального сайта: https://www.python.org/downloads/
- Важно: При установке обязательно поставьте галочку ✅ "Add Python to PATH"
- Нажмите "Install Now"
- После установки откройте PowerShell и проверьте:
python --version
🐧 Linux (Ubuntu/Debian)
sudo apt update
sudo apt install python3.12 python3.12-venv python3-pip git -y🍎 macOS
# Через Homebrew
brew install python@3.12 git📦 Способ 1: Автоматическая установка (рекомендуется)
- Скачайте ZIP-архив или склонируйте репозиторий
- Распакуйте архив в удобную папку (например
C:\Maxli) - Запустите файл
install_windows.batдвойным кликом - Следуйте инструкциям в консоли:
- Введите номер телефона в формате
+79001234567 - Введите код подтверждения из мессенджера Max
- Введите номер телефона в формате
- Готово! Бот запущен 🎉
⌨️ Способ 2: Ручная установка через PowerShell
Откройте PowerShell и выполните команды по очереди:
# 1. Клонируем репозиторий
git clone https://github.com/Igroshka/Maxli.git
# 2. Переходим в папку проекта
cd Maxli
# 3. Создаём виртуальное окружение
python -m venv venv
# 4. Активируем виртуальное окружение
venv\Scripts\activate
# 5. Устанавливаем зависимости
pip install -r requirements.txt
# 6. Запускаем бота
python main.pyПри первом запуске:
- Введите номер телефона в формате
+79001234567 - Введите код подтверждения из мессенджера Max
📦 Способ 1: Автоматическая установка (рекомендуется)
# 1. Клонируем репозиторий
git clone https://github.com/Igroshka/Maxli.git
# 2. Переходим в папку
cd Maxli
# 3. Даём права на выполнение скрипта
chmod +x install_linux.sh
# 4. Запускаем установку
./install_linux.shСледуйте инструкциям:
- Введите номер телефона в формате
+79001234567 - Введите код подтверждения из мессенджера Max
⌨️ Способ 2: Ручная установка
# Всё в одной команде:
git clone https://github.com/Igroshka/Maxli.git && cd Maxli && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt && python3 main.pyИли пошагово:
# 1. Клонируем репозиторий
git clone https://github.com/Igroshka/Maxli.git
# 2. Переходим в папку проекта
cd Maxli
# 3. Создаём виртуальное окружение
python3 -m venv venv
# 4. Активируем виртуальное окружение
source venv/bin/activate
# 5. Устанавливаем зависимости
pip install -r requirements.txt
# 6. Запускаем бота
python3 main.pyПосле установки для запуска бота достаточно:
Windows (PowerShell):
cd C:\путь\к\Maxli
venv\Scripts\activate
python main.pyLinux:
cd ~/Maxli
source venv/bin/activate
python3 main.py🖥️ Windows — через Планировщик задач
- Откройте Планировщик задач (нажмите
Win+R, введитеtaskschd.msc) - Нажмите "Создать задачу..." (не "Создать простую задачу")
- На вкладке "Общие":
- Название:
Maxli - Поставьте галочку "Выполнять с наивысшими правами"
- Название:
- На вкладке "Триггеры":
- Нажмите "Создать..."
- Выберите "При входе в систему"
- ОК
- На вкладке "Действия":
- Нажмите "Создать..."
- Действие: "Запуск программы"
- Программа: путь к
autostart.batв папке Maxli - ОК
- Сохраните задачу
🐧 Linux — через systemd
-
Отредактируйте файл сервиса (укажите ваш путь и пользователя):
nano maxli.service
-
Скопируйте сервис в системную директорию:
sudo cp maxli.service /etc/systemd/system/
-
Перезагрузите конфигурацию systemd:
sudo systemctl daemon-reload
-
Включите автозапуск:
sudo systemctl enable maxli -
Запустите сервис:
sudo systemctl start maxli
-
Проверьте статус:
sudo systemctl status maxli
Maxli/
├── 📄 main.py # ▶️ Основной файл для запуска
├── 📁 core/ # ⚙️ Ядро и ключевые компоненты
│ ├── api.py # API-обёртка над PyMax
│ ├── config.py # Конфигурация
│ └── loader.py # Загрузчик модулей
├── 📁 core_modules/ # 🔧 Встроенные модули
├── 📁 modules/ # 🧩 Ваши пользовательские модули
├── 📁 mods/ # 📚 Документация по созданию модулей
│ └── README.md # Руководство разработчика
├── 📄 requirements.txt # 📦 Список зависимостей
├── 📄 install_windows.bat # 🖥️ Скрипт установки для Windows
├── 📄 install_linux.sh # 🐧 Скрипт установки для Linux
└── 📄 README.md # 📄 Эта документация
Хотите создать свой модуль? Ознакомьтесь с документацией для разработчиков.
Maxli использует библиотеку PyMax — вы можете использовать все её возможности в своих модулях!
# name: Мой модуль
# version: 1.0.0
# developer: Ваше имя
# id: my_module
# min-maxli: 35
async def hello_command(api, message, args):
"""Простое приветствие."""
await api.edit(message, "👋 **Привет!**", markdown=True)
async def register(api):
api.register_command("hello", hello_command)Где взять код подтверждения?
Код придёт в мессенджер Max на ваш телефон после ввода номера.
Бот не запускается, что делать?
- Убедитесь, что Python версии 3.12 или выше:
python --version - Проверьте, что виртуальное окружение активировано (в начале строки должно быть
(venv)) - Попробуйте переустановить зависимости:
pip install -r requirements.txt --force-reinstall
Как обновить бота?
cd Maxli
git pull
pip install -r requirements.txt --upgradeКак удалить сессию и войти заново?
Удалите файл session.json в папке проекта и перезапустите бота.
Этот проект распространяется под лицензией Apache License 2.0.
Подробнее см. в файле LICENSE.
⭐ Если вам нравится проект, поставьте звезду на GitHub! ⭐