⚡️ Лучший UserBot для мессенджера Max с удобной системой модулей и легкостью.
Создан Moyunni с ❤️
Maximus — это новаторский UserBot для мессенджера Max, разработанный для автоматизации рутинных действий и расширения стандартного функционала. Это первый в своем роде юзербот для данной платформы, предлагающий пользователям непревзойденные возможности.
Проект работает на Python и использует библиотеку PyMax (maxapi-python) для взаимодействия с API мессенджера Max. Благодаря своей архитектуре, Maximus легко запускается как на VDS/VPS, так и на локальной машине, а его система плагинов обеспечивает простую кастомизацию и расширение.
- Автоматизация: Настраивайте автоматические ответы, команды и сценарии
- Гибкая система модулей: Расширяйте функционал с помощью готовых плагинов или создавайте свои
- Поддержка чатов: Стабильная работа в личных сообщениях и групповых чатах
- Простая установка: Готовые скрипты для быстрой установки на Windows и Linux
- Удобная настройка: Конфигурация через простые и понятные файлы
- Markdown: Поддержка форматирования текста (жирный, курсив, подчёркивание)
- Медиа: Отправка фото, файлов и видео
Все актуальные новости, обновления и полезную информацию о проекте вы найдете в нашем официальном Telegram-канале.
➡️ Подписаться на канал: moyunni_room.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 -ymacOS
# Через Homebrew
brew install python@3.12 gitРучная установка через PowerShell
Откройте PowerShell и выполните команды по очереди:
# 1. Клонируем репозиторий
git clone https://github.com/moyunnis/Maximus.git
# 2. Переходим в папку проекта
cd Maximus
# 3. Создаём виртуальное окружение
python -m venv venv
# 4. Активируем виртуальное окружение
venv\Scripts\activate
# 5. Устанавливаем зависимости
pip install -r requirements.txt
# 6. Запускаем бота
python main.pyПри первом запуске:
- Введите номер телефона в формате
+79001234567 - Введите код подтверждения из мессенджера Max
Ручная установка
# Всё в одной команде:
git clone https://github.com/moyunnis/Maximus.git && cd Maximus && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt && python3 main.pyИли пошагово:
# 1. Клонируем репозиторий
git clone https://github.com/moyunnis/Maximus.git
# 2. Переходим в папку проекта
cd Maximus
# 3. Создаём виртуальное окружение
python3 -m venv venv
# 4. Активируем виртуальное окружение
source venv/bin/activate
# 5. Устанавливаем зависимости
pip install -r requirements.txt
# 6. Запускаем бота
python3 main.pyПосле установки для запуска бота достаточно использовать стартовые скрипты:
Windows:
# Просто дважды кликните по start.bat
# Или в PowerShell:
.\run.batLinux:
# Сделайте скрипт исполняемым (один раз):
chmod +x run.sh
# Запускайте:
./run.shWindows — через Планировщик задач
- Откройте Планировщик задач (нажмите
Win+R, введитеtaskschd.msc) - Нажмите "Создать задачу..." (не "Создать простую задачу")
- На вкладке "Общие":
- Название:
Maximus - Поставьте галочку "Выполнять с наивысшими правами"
- Название:
- На вкладке "Триггеры":
- Нажмите "Создать..."
- Выберите "При входе в систему"
- ОК
- На вкладке "Действия":
- Нажмите "Создать..."
- Действие: "Запуск программы"
- Программа: путь к
run.batв папке Maximus - ОК
- Сохраните задачу
Linux — через systemd (systemd хуйня, btw)
-
Отредактируйте файл сервиса (укажите ваш путь и пользователя):
nano maximus.service
-
Скопируйте сервис в системную директорию:
sudo cp maximus.service /etc/systemd/system/
-
Перезагрузите конфигурацию systemd:
sudo systemctl daemon-reload
-
Включите автозапуск:
sudo systemctl enable maximus -
Запустите сервис:
sudo systemctl start maximus
-
Проверьте статус:
sudo systemctl status maximus
ЕЕ СЪЕЛИ КРОКОДИЛЫ
Прямо из коробки, без установки модулей (префикс по умолчанию — .):
| Команда | Что делает |
|---|---|
.info |
Инфо о боте: аптайм, версия, кол-во модулей/команд, хост, Python, PyMax |
.help |
Список всех команд и модулей; .help <модуль> — подробнее |
.ping |
Задержка + аптайм |
.uptime |
Сколько работает юзербот |
.id |
ID чата, твой ID и (при реплае) ID автора/сообщения |
.calc <выражение> |
Безопасный калькулятор: .calc (2 + 3) * 4 |
.whois [id] |
Инфо о пользователе (реплаем или по ID) |
.repeat <N> <текст> |
Повторить текст N раз |
.config / .configset |
Просмотр и изменение переменных модулей |
.load / .unload / .modules |
Управление модулями |
.reload / .update / .restart |
Перезагрузка модулей / обновление ядра / рестарт |
.backup / .loadbackup |
Бэкап и восстановление конфига и модулей |
.exportlog [N] |
Выгрузить последние N строк логов файлом |
.setprefix / .addalias / .remalias |
Префикс и алиасы команд |
Хотите создать свой модуль? ЗАЙДИТЕ В !!!ПОРТАЛ В РОБЛОКС!!!.
Maximus использует библиотеку PyMax — вы можете использовать все её возможности в своих модулях!
# name: Мой модуль
# version: 1.0.0
# developer: Ваше имя
# id: my_module
# min-Maximus: 100
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 Maximus
git pull
pip install -r requirements.txt --upgradeКак удалить сессию и войти заново?
Удалите папку pymax_session/ в папке проекта и перезапустите бота.
Этот проект распространяется под лицензией Apache License 2.0.
Подробнее см. в файле LICENSE.
⭐ Если вам нравится проект, поставьте звезду на Github! ⭐
- Проект является улучшенным форком Maxli