bilal
a18ad30961
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)
113 lines
2.5 KiB
Markdown
113 lines
2.5 KiB
Markdown
# 🚀 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`)
|