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:
112
QUICKSTART.md
Normal file
112
QUICKSTART.md
Normal 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`)
|
||||
Reference in New Issue
Block a user