YouTube Creator AI Assistant - Telegram Bot

Профессиональный Telegram-бот для YouTube-креаторов, использующий Google Gemini API для генерации идей контента, оптимизации заголовков и адаптации контента для коротких форматов.

🎯 Возможности

• 🎥 Генератор идей для видео - Создает 5-7 идей на основе ниши, темы или целевой аудитории
• 📝 Генератор заголовков и описаний - Оптимизированные заголовки и SEO-описания для видео
• 🎬 Адаптация для Shorts/TikTok - Преобразует длинный контент в сценарии для коротких форматов

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

Требования

• Python 3.8+
• Telegram Bot Token (получить у @BotFather)
• Google Gemini API Key (получить в Google AI Studio)

Установка

1. Клонируйте репозиторий или скачайте файлы

2. Установите зависимости:

pip install -r requirements.txt

3. Создайте файл .env на основе .env.example:

cp .env.example .env

4. Заполните .env файл:

TELEGRAM_BOT_TOKEN=ваш_токен_от_BotFather
GEMINI_API_KEY=ваш_ключ_Gemini_API
LOG_LEVEL=INFO

Запуск

python bot.py

Бот начнет работать и будет отвечать на команды в Telegram.

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

.
├── bot.py                 # Главный файл бота
├── config.py             # Управление конфигурацией
├── prompts.py            # Шаблоны промптов для AI
├── requirements.txt      # Зависимости Python
├── .env.example          # Пример файла конфигурации
├── README.md             # Документация
├── handlers/             # Обработчики команд и сообщений
│   ├── __init__.py
│   ├── base_handler.py  # Базовый класс для обработчиков
│   ├── command_handler.py  # Обработка команд (/start, /menu)
│   └── feature_handler.py  # Обработка функций бота
└── services/             # Бизнес-логика
    ├── __init__.py
    └── gemini_service.py  # Сервис для работы с Gemini API

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

1. Найдите вашего бота в Telegram
2. Отправьте команду /start
3. Выберите нужную функцию из меню:
   • 🎥 Идеи для видео - укажите нишу или тему
   • 📝 Заголовок и описание - опишите идею видео
   • 🎬 Shorts / TikTok - отправьте текст для адаптации

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

Переменные окружения

• TELEGRAM_BOT_TOKEN - токен Telegram бота (обязательно)
• GEMINI_API_KEY - ключ API Google Gemini (обязательно)
• LOG_LEVEL - уровень логирования (DEBUG, INFO, WARNING, ERROR), по умолчанию INFO

Логирование

Логи сохраняются в файл bot.log и выводятся в консоль.

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

Бот построен с модульной архитектурой для легкого масштабирования:

• Разделение ответственности: Telegram логика отделена от AI логики
• Сервисный слой: Вся работа с API вынесена в отдельные сервисы
• Обработчики: Каждый тип взаимодействия имеет свой обработчик
• Конфигурация: Централизованное управление настройками

🔒 Безопасность

• API ключи хранятся в .env файле (не коммитьте его в Git!)
• Обработка ошибок на всех уровнях
• Валидация входных данных
• Логирование для отладки

📈 Масштабируемость

Архитектура спроектирована для будущего расширения:

• Поддержка нескольких AI агентов
• Веб-интерфейс
• Пользовательские настройки
• Монетизация

🐛 Решение проблем

Бот не отвечает

• Проверьте, что токен бота правильный
• Убедитесь, что бот запущен (python bot.py)
• Проверьте логи в bot.log

Ошибки API

• Проверьте правильность GEMINI_API_KEY
• Убедитесь, что у вас есть доступ к Gemini API
• Проверьте квоты API в Google Cloud Console

Ошибки импорта

• Убедитесь, что установлены все зависимости: pip install -r requirements.txt
• Проверьте версию Python (должна быть 3.8+)

📝 Лицензия

Этот проект создан для демонстрации возможностей AI-ассистента для YouTube-креаторов.

🤝 Поддержка

При возникновении проблем проверьте логи в файле bot.log или создайте issue в репозитории проекта.