Beauty AI Photo Enhancer Bot (Demo) 🤖✨

❗ Внимание

Этот репозиторий содержит демонстрационную версию Telegram-бота для обработки фото при помощи нейросети Nano Banana.

Полная версия включает расширенный функционал для обработки фотографий и продвинутую логику UX, доступна по запросу или в рамках коммерческого сотрудничества.

---

📌 Недавние обновления

• Добавлена база данных и история обработок (до 6 последних фото) с выбором миниатюр.
• Кеширование: при одинаковом запросе бот возвращает готовый результат без повторного расхода кредитов.
• Устойчивость: таймауты, защита от двойных нажатий и понятные сообщения об ошибках.

🎯 Полная версия (непубличная)

Полная версия бота позволяет:

• Улучшать и обрабатывать фотографии лица с помощью нейросети Gemini 2.5 Flash Image(Nano Banana)
• Использовать профессиональные предустановленные фильтры и создавать собственные промпты
• Многоступенчатую обработку с кэшированием и историей фото
• Хранение истории фото и данных пользователя (до 6 последних фото)
• Экономия кредитов: при повторном запросе с теми же параметрами бот отдаёт готовый результат из истории (кеш).
• Интерактивные UX-подсказки и клавиатуры на всех этапах работы
• Защиту от ошибок и повторных нажатий
• Поддержку отмены действий и возврата в главное меню
• Оптимизированную работу с API, асинхронную обработку и надёжный таймаут
• Расширяемую архитектуру для дальнейших доработок и интеграций

---

⚡ Доступная демо-версия

В этой публичной версии реализовано:

• Команды /start и /help
• Минимальная клавиатура и интерфейс для демонстрации работы бота
• Структура проекта с разделением на handlers, keyboards, states, config
• Демонстрация навыков разработки Telegram-ботов с FSM, обработкой команд и сообщений
• Показ базовой логики работы и структуры проекта без использования реальных ключей PiAPI и ImgBB

🔹 Обратите внимание: в демо-версии отсутствует интеграция с API, обработка изображений и продвинутый UX.

---

💻 Установка

git clone https://github.com/yourusername/beauty-tgbot-demo.git
cd beauty_tgbot
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env      # Заполните BOT_TOKEN
python beauty_tgbot/main.py

🛠 Применённые технологии и навыки (демо-версия)

• Python 3.12
• aiogram (FSM, Routers, CallbackQuery, InlineKeyboard)
• Работа с состояниями пользователя через FSM
• Организация структуры проекта для масштабируемости
• Работа с клавиатурами и обработкой команд
• Полная версия демонстрирует также:
• Асинхронную работу с внешними API (PiAPI, ImgBB)
• Кэширование фото, повторную обработку и историю
• Обработку ошибок и защиту от повторных запросов
• Продвинутый UX и подсказки для пользователей

📩 Как получить полную версию

Если вы хотите:

• Оценить полный функционал бота

• Использовать его в коммерческих проектах

• Начать сотрудничество по расширению функционала

Свяжитесь со мной напрямую, чтобы получить полную версию и инструкцию по развёртыванию.

👨‍💻 Разработчик

Алекасандр