Objopa Bot 🤖

Многофункциональный Telegram-бот с микросервисной архитектурой. Поддерживает скачивание медиа, интеграции с AI, мини-игры и многое другое.

🏗️ Архитектура

• 🤖 tg_bot – Telegram-бот с командами и роутерами
• 🔧 backend – FastAPI сервер для API и интеграций
• ⚙️ workers – Фоновые задачи и обработка
• 🔴 Redis – Кэширование и обмен данными между сервисами

📥 Система скачивания медиа

Команды:

• /d <url> - Универсальная команда скачивания
• /insta <url> - Специально для Instagram
• /d_test <url> - Диагностика системы

Управление Instagram:

• /ua_current - статус User-Agent
• /ua_set <UA> - установить новый User-Agent
• /ua_reset - сбросить на дефолтный
• /insta_session - статус системы
• /insta_reset - сброс кэша

Особенности:

✅ Приоритетная система: Кастомные скачиватели → yt-dlp → gallery-dl
✅ Динамический User-Agent: Изменение без перезапуска через Redis
✅ Строгий режим: Instagram/Twitter не пробуют fallback методы
✅ Нет дублирования: Каждый URL обрабатывается один раз
✅ Автодиагностика: Детальные отчеты о работе системы

🚀 Быстрый старт

Требования:

• Python 3.13.5
• uv
• Redis
• Make

Установка:

git clone https://github.com/Red0Core/objopa_bot.git
cd objopa_bot
make install

# Настройка окружения
cp .env.example .env
# Заполните .env файл необходимыми токенами

Запуск:

# Запуск бота
make run-bot

# Запуск API (в другом терминале)
make run-api

📝 Структура проекта

objopa_ecosystem/
├── tg_bot/           # Telegram бот
│   ├── routers/      # Команды и обработчики
│   ├── downloaders/  # Система скачивания
│   └── services/     # Сервисы (UA, GPT и др.)
├── backend/          # FastAPI сервер
├── workers/          # Фоновые задачи
├── core/            # Общие компоненты
│   ├── config.py    # Конфигурация
│   ├── logger.py    # Логирование
│   └── redis_client.py # Redis подключение
└── docs/            # Документация

🔧 Конфигурация

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

# Telegram
TELEGRAM_BOT_TOKEN=your_bot_token

# Redis
REDIS_URL=redis://localhost:6379

# Instagram (опционально для продвинутых функций)
INSTAGRAM_USERNAME=your_username

# Twitter (опционально)
TWITTER_AUTH_TOKEN=your_token
TWITTER_CT0=your_csrf_token

📖 Использование

Скачивание медиа:

# Instagram
/d https://instagram.com/p/ABC123/

# YouTube
/d https://youtube.com/watch?v=ABC123

# Twitter/X
/d https://x.com/user/status/123456

Управление Instagram User-Agent:

# Проверить статус
/ua_current

# Установить новый UA (при блокировках)
/ua_set Mozilla/5.0 (Linux; Android 14...)

# Сбросить на дефолтный
/ua_reset

Диагностика:

# Тест системы скачивания
/d_test https://instagram.com/p/ABC123/

# Статус Instagram системы  
/insta_session

# Общий статус компонентов
/d_status

🐳 Docker

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

# Только бот
docker-compose up tg_bot

# Логи
docker-compose logs -f

🔄 Управление

Обновление:

git pull
make restart-bot
make restart-api

Мониторинг:

# Логи бота
tail -f logs/bot.log

# Статус Redis
redis-cli ping

📚 Документация

• 📥 Система скачивания - Подробное описание системы скачивания
• 🔧 Разработка - Руководство для разработчиков

🤝 Участие в разработке

1. Fork репозитория
2. Создайте feature branch (git checkout -b feature/amazing-feature)
3. Commit изменения (git commit -m 'Add amazing feature')
4. Push в branch (git push origin feature/amazing-feature)
5. Откройте Pull Request

📋 TODO

• Добавить поддержку TikTok
• Улучшить систему кэширования
• Добавить метрики производительности
• Веб-интерфейс для управления

📄 Лицензия

Этот проект лицензирован под MIT License - см. LICENSE файл.

📞 Контакты

• Telegram: @Red0Core
• GitHub: Red0Core

---

⭐ Поставьте звезду, если проект был полезен!