Files
batch-bot/QUICKSTART.md
bilal a18ad30961 Initial commit: Batch Bot - Telegram Comment Bot
0.0.1
Features:
- Multi-account support via session files
- AI comments generation via Ollama (local LLM)
- Telegram bot for moderation (approve/reject/regenerate)
- Docker support (controller + worker)
- Auto-join public groups
- Comment regeneration on group re-add
- Statistics tracking

Tech stack:
- Python 3.11
- Telethon 1.34 (Telegram user client)
- Aiogram 3.4 (Telegram bot framework)
- SQLite (Database)
- Docker & Docker Compose
- Ollama (Local LLM)
2026-02-24 04:40:07 +03:00

2.5 KiB
Raw Blame History

🚀 Quick Start

1. Настройка

cd batch-bot

# Скопируйте .env.example в .env
cp .env.example .env

# Отредактируйте .env
nano .env

Обязательные параметры:

Параметр Где взять
BOT_TOKEN @BotFather в Telegram
TELEGRAM_API_ID my.telegram.org
TELEGRAM_API_HASH my.telegram.org
TARGET_GROUP_ID ID канала (через @RawDataBot)
LOG_GROUP_ID ID чата модерации (с -100)
ADMIN_IDS Ваш Telegram ID (через @userinfobot)

2. Создание сессии

# Установка зависимостей
pip install -r requirements.txt

# Создание сессии
python auth.py

Введите:

  1. Номер телефона
  2. Код из Telegram

Для нескольких аккаунтов:

  • Запустите python auth.py несколько раз
  • Или скопируйте .session файлы в sessions/

3. Запуск Docker

# Сборка и запуск
docker-compose build
docker-compose up -d

# Логи
docker-compose logs -f

4. Проверка

  1. Откройте бота в Telegram
  2. Отправьте /start
  3. Проверьте /stats

📝 Команды

Команда Описание
/start Главное меню
/stats Статистика
/pending Ожидающие комментарии
/sessions Сессии
/groups Список групп
/add_group Добавить группу
/help Справка

⚙️ Настройка Ollama URL

Linux (Docker bridge):

OLLAMA_URL=http://172.17.0.1:11434

Проверка:

curl http://172.17.0.1:11434/api/tags

⚠️ Важно

  1. Ollama должна быть запущена отдельно (не в Docker)
  2. Бот должен быть администратором в LOG_GROUP_ID
  3. Сессии должны быть в папке sessions/

🐛 Ошибки

"BOT_TOKEN не задан":

  • Проверьте .env и BOT_TOKEN

"Нет сессий":

  • Запустите python auth.py

"Ollama не отвечает":

  • Проверьте: curl http://172.17.0.1:11434/api/tags

"Не удалось найти группу":

  • Добавьте бота в группу модерации
  • Проверьте LOG_GROUP_ID (должен быть с -100)