MCUB-fork install

для VDS (Ubuntu/Mint/Debian/...):

sudo apt update ; sudo apt install python3 python3-pip git -y ; git clone https://github.com/hairpin01/MCUB-fork.git && cd MCUB-fork ; pip install -r requirements.txt && python3 MCUB.py

Arch linux:

sudo pacman -Sy ; sudo pacman -S python3 python-pip git ; git clone https://github.com/hairpin01/MCUB-fork.git && cd MCUB-fork ; pip install -r requirements.txt && python3 MCUB.py

Fedora:

sudo dnf update -y && sudo dnf install python3 python3-pip git -y && git clone https://github.com/hairpin01/MCUB-fork.git && cd MCUB-fork && pip3 install -r requirements.txt && python3 MCUB.py

Termux:

Поставте termux с github (релиз)

pkg update && pkg upgrade -y && pkg install python3 git rust -y && pip install --upgrade pip && git clone https://github.com/hairpin01/MCUB-fork.git && cd MCUB-fork && pip install -r requirements.txt && python MCUB.py

UserLAnd:

Ставим UserLAnd с github

Bыбераем: Ubuntu -> Minimal -> terminal

sudo apt update && sudo apt upgrade -y && sudo apt install python3 python3-pip git -y && git clone https://github.com/hairpin01/MCUB-fork.git && cd MCUB-fork && pip3 install --user -r requirements.txt && python3 MCUB.py

если у вас не ставятся зависимости (Error: externally-managed-environment)

sudo apt install python3-venv -y &&
python3 -m venv venv &&
source venv/bin/activate &&
pip install -r requirements.txt &&
python3 MCUB.py &&

шо такое MCUB (MCUB-fork)

MCUB — это модульный юзербот для Telegram на основе Telethon, позволяющий создавать и загружать собственные модули для автоматизации действий в аккаунте Telegram. Отличается (от MCUBFB) улучшенным API, правильной структурой и встроенными инструментами для разработки модулей.

Note: MCUB-fork - это форк MCUBFB [github]

Две фичи MCUB

inline_form() — создание интерактивных форм

Позволяет генерировать и отправлять структурированные сообщения с полями и кнопками прямо в чат. Идеально для меню, профилей, панелей управления.

Пример:

success, msg = await kernel.inline_form(
    event.chat_id,
    "👤 Профиль",
    fields={"Имя": "Алексей", "Баланс": "1000 ₽"},
    buttons=[
        {"text": "Пополнить", "data": "deposit"},
        {"text": "История", "data": "history"}
    ]
)

Управление разрешениями для callback-кнопок через CallbackPermissionManager

Встроенная система контроля доступа к inline-кнопкам: можно временно разрешать определённым пользователям нажимать кнопки с заданным паттерном, а затем автоматически отзывать права. По умолчанию кнопки доступны только владельцу MCUB.

Пример:

perm_mgr.allow(user_id, 'game_', duration_seconds=300)  # Разрешить на 5 минут
if data == 'game_':
  # ...

Все поддробности API в API_DOC.md

Support MCUB

*click*