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)
This commit is contained in:
2026-02-24 04:40:07 +03:00
commit a18ad30961
20 changed files with 3431 additions and 0 deletions

112
QUICKSTART.md Normal file
View File

@@ -0,0 +1,112 @@
# 🚀 Quick Start
## 1. Настройка
```bash
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. Создание сессии
```bash
# Установка зависимостей
pip install -r requirements.txt
# Создание сессии
python auth.py
```
Введите:
1. Номер телефона
2. Код из Telegram
**Для нескольких аккаунтов:**
- Запустите `python auth.py` несколько раз
- Или скопируйте `.session` файлы в `sessions/`
## 3. Запуск Docker
```bash
# Сборка и запуск
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
```
**Проверка:**
```bash
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`)