Binary Userbot - Windows
bincoreБыстрый старт
winget install --id Python.Python.3.11 -e
winget install --id Git.Git -e
winget install --id Gyan.FFmpeg -e
cd "$env:USERPROFILE\Desktop"
git clone https://github.com/binary166/BinaryUserBot
Set-Location .\BinaryUserBot
if (Test-Path .\BinaryUserBot\main.py) { Set-Location .\BinaryUserBot }
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip setuptools wheel
if (Test-Path .\requirements.txt) { python -m pip install -r requirements.txt } else { python -m pip install telethon aiohttp yt-dlp }
notepad .\config.py
python .\main.py
Ниже идет более подробная помощь, автозапуск и ответы на вопросы.
Эта инструкция подходит для Windows 10 и Windows 11. Рекомендуемый терминал - PowerShell.
1. Что нужно заранее
Подготовьте:
- Telegram-аккаунт, на котором будет работать userbot.
- Windows 10/11.
- Python 3.10+, лучше 3.11+.
- Git.
- FFmpeg.
- Telegram API_ID и API_HASH.
- Ваш Telegram User ID.
- OpenRouter API Token, если нужны AI-функции.
Репозиторий:
https://github.com/binary166/BinaryUserBot
2. Обязательная подписка
Перед первым запуском обязательно подпишитесь с того Telegram-аккаунта, на котором будет работать userbot:
Это обязательное условие для нормальной работы функций, связанных со скам-базой, новостями, обновлениями, модулями и поддержкой проекта.
3. Получение Telegram API ID и API Hash
- Откройте
- https://my.telegram.org.
- Войдите по номеру телефона Telegram.
- Перейдите в API development tools.
- Создайте приложение. Название и описание можно указать любые.
- Скопируйте:App api_id
- App api_hash
Пример:
API_ID = 12345678
API_HASH = "abcdef123456abcdef123456abcdef12"
Не передавайте эти данные другим людям.
4. Получение Telegram User ID
- Откройте Telegram.
- Напишите боту
- https://t.me/userinfobot.
- Скопируйте числовой ID.
Пример:
MY_ID = 750545571
5. Получение OpenRouter API Token
Токен нужен для AI-команд, например .gpt, .ac, .lol, .troll.
- Откройте
- https://openrouter.ai.
- Зарегистрируйтесь или войдите.
- Перейдите в Settings -> API Keys.
- Создайте ключ через Create Key.
- Скопируйте токен.
Если AI-функции не нужны:
OR_TOKEN = ""
6. Установка Python, Git и FFmpeg через winget
Откройте PowerShell и выполните:
winget install --id Python.Python.3.11 -e
winget install --id Git.Git -e
winget install --id Gyan.FFmpeg -e
После установки закройте PowerShell и откройте заново.
Проверьте:
python --version
py --version
git --version
ffmpeg -version
Если команды не находятся, перезагрузите Windows или проверьте переменную среды PATH.
7. Ручная установка, если winget не работает
- Скачайте Python с
- https://www.python.org/downloads/.
- Во время установки обязательно включите Add Python to PATH.
- Скачайте Git с
- https://git-scm.com/download/win.
- Установите FFmpeg и добавьте папку bin в PATH.
- Закройте и снова откройте PowerShell.
Проверка:
python --version
git --version
ffmpeg -version
8. Скачивание проекта через PowerShell
Перейдите на рабочий стол:
cd "$env:USERPROFILE\Desktop"
Скачайте проект:
git clone https://github.com/binary166/BinaryUserBot
Set-Location .\BinaryUserBot
В некоторых версиях проекта внутри может быть еще одна папка BinaryUserBot. Перейдите в нее, если там лежит main.py:
if (Test-Path .\BinaryUserBot\main.py) {
Set-Location .\BinaryUserBot
}
Проверьте, что main.py есть в текущей папке:
Get-ChildItem
Если main.py не видно:
Get-ChildItem -Recurse -Filter main.py
Перейдите в найденную папку.
9. Создание виртуального окружения
py -3 -m venv .venv
Активируйте:
.\.venv\Scripts\Activate.ps1
Если появилась ошибка running scripts is disabled, выполните:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Закройте PowerShell, откройте заново и повторите:
cd "$env:USERPROFILE\Desktop\BinaryUserBot"
if (Test-Path .\BinaryUserBot\main.py) {
Set-Location .\BinaryUserBot
}
.\.venv\Scripts\Activate.ps1
10. Установка Python-библиотек
python -m pip install --upgrade pip setuptools wheel
Если есть requirements.txt:
python -m pip install -r requirements.txt
Если файла нет:
python -m pip install telethon aiohttp yt-dlp
Можно использовать автоматический вариант:
if (Test-Path .\requirements.txt) {
python -m pip install -r requirements.txt
} else {
python -m pip install telethon aiohttp yt-dlp
}
11. Настройка config.py
Откройте конфиг:
notepad .\config.py
Заполните основные поля:
API_ID = 12345678
API_HASH = "abcdef123456abcdef123456abcdef12"
PHONE = "+79001234567"
PASSWORD_2FA = ""
MY_ID = 123456789
OR_TOKEN = ""
Расшифровка:
- API_ID - число с my.telegram.org.
- API_HASH - строка с my.telegram.org.
- PHONE - ваш номер Telegram в международном формате.
- PASSWORD_2FA - пароль двухфакторной аутентификации Telegram. Если его нет, оставьте "".
- MY_ID - ваш числовой Telegram ID.
- OR_TOKEN - токен OpenRouter. Если AI не нужен, оставьте "".
Сохраните файл в Блокноте через Ctrl + S.
12. Первый запуск
Убедитесь, что окружение активно:
.\.venv\Scripts\Activate.ps1
Запустите:
python .\main.py
При первом запуске Telegram может попросить:
- Ввести код из Telegram.
- Ввести пароль 2FA, если он установлен.
После успешного входа появится файл *.session. Не передавайте его другим людям.
13. Проверка работы
- Откройте Telegram.
- Проверьте, что аккаунт подписан на:@GID_ScamBase
- @Binary_News
- @binary_ub
- Напишите .help в чате.
- Если бот отвечает, установка завершена.
14. Повторный запуск
cd "$env:USERPROFILE\Desktop\BinaryUserBot"
if (Test-Path .\BinaryUserBot\main.py) {
Set-Location .\BinaryUserBot
}
.\.venv\Scripts\Activate.ps1
python .\main.py
15. Запуск через CMD
Если вы используете обычную командную строку:
cd /d %USERPROFILE%\Desktop
git clone https://github.com/binary166/BinaryUserBot
cd BinaryUserBot
if exist BinaryUserBot\main.py cd BinaryUserBot
py -3 -m venv .venv
.venv\Scripts\activate.bat
python -m pip install --upgrade pip setuptools wheel
if exist requirements.txt (
python -m pip install -r requirements.txt
) else (
python -m pip install telethon aiohttp yt-dlp
)
notepad config.py
python main.py
16. BAT-файл для удобного запуска
Создайте рядом с main.py файл run_binary_userbot.bat:
@echo off
cd /d "%~dp0"
call .venv\Scripts\activate.bat
python main.py
pause
Теперь можно запускать бота двойным кликом по run_binary_userbot.bat.
17. Автозапуск Windows
- Нажмите Win + R.
- Введите:
shell:startup
- Нажмите Enter.
- Поместите ярлык на run_binary_userbot.bat в открывшуюся папку.
Минус: бот запустится только после входа пользователя в Windows.
18. Обновление
Остановите бота и выполните:
cd "$env:USERPROFILE\Desktop\BinaryUserBot"
if (Test-Path .\BinaryUserBot\main.py) {
Set-Location .\BinaryUserBot
}
git pull
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip setuptools wheel
if (Test-Path .\requirements.txt) {
python -m pip install -r requirements.txt --upgrade
} else {
python -m pip install --upgrade telethon aiohttp yt-dlp
}
python .\main.py
19. Резервная копия
Сохраните:
- config.py
- *.session
- settings.json, если есть
- notes.json, если есть
- папку modules, если есть
Файл *.session равен доступу к аккаунту. Не отправляйте его никому.
20. Частые ошибки
python не найден
- Переустановите Python.
- Включите Add Python to PATH.
- Перезапустите PowerShell.
- Проверьте:
py -3 --version
git не найден
Установите Git с
https://git-scm.com/download/win и перезапустите терминал.
ffmpeg не найден
Установите FFmpeg и добавьте папку bin в PATH.
Проверка:
ffmpeg -version
PowerShell запрещает активацию окружения
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
После этого откройте новый PowerShell.
ModuleNotFoundError
.\.venv\Scripts\Activate.ps1
python -m pip install telethon aiohttp yt-dlp
main.py не найден
Get-ChildItem -Recurse -Filter main.py
Перейдите в найденную папку.
FloodWaitError
Это лимит Telegram. Подождите указанное время и не перезапускайте бота слишком часто.
AI-команды не работают
Проверьте:
- заполнен ли OR_TOKEN;
- активен ли ключ OpenRouter;
- есть ли доступ к модели;
- нет ли лишних пробелов в токене.
Команды .scam или .lastnews не работают
Проверьте обязательную подписку:
- @GID_ScamBase
- @Binary_News
- @binary_ub
21. Короткая установка через PowerShell
cd "$env:USERPROFILE\Desktop"
git clone https://github.com/binary166/BinaryUserBot
Set-Location .\BinaryUserBot
if (Test-Path .\BinaryUserBot\main.py) { Set-Location .\BinaryUserBot }
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip setuptools wheel
if (Test-Path .\requirements.txt) { python -m pip install -r requirements.txt } else { python -m pip install telethon aiohttp yt-dlp }
notepad .\config.py
python .\main.py