🤖 VanVan AI - Telegram бот для генерации изображений

📋 О проекте / Проект жөнүндө

Автор: Абдырахманов Абдыкадыр
Тип проекта: Дипломная работа
Описание: Telegram бот для генерации и редактирования изображений с использованием искусственного интеллекта (Google Gemini API)

🇷🇺 Описание проекта

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

✨ Основные возможности:

🎨 Генерация изображений - создание уникальных изображений по текстовому описанию
🖼️ Редактирование фото - изменение стиля, фона и добавление деталей к существующим изображениям
🎭 Скрещивание фото - объединение двух изображений в одно на основе инструкций
📱 Создание карточек для маркетплейсов - автоматическая генерация карточек товаров для Wildberries, Ozon, Yandex Market
👤 Модельные фото - генерация портретов и модельных фотографий
💳 Система подписок - различные тарифные планы с лимитами генераций
🤝 Реферальная программа - приглашение друзей и получение бонусов
👨‍💼 Админ-панель - полное управление пользователями, аналитика, рассылки
🧠 Контекстная память - бот помнит последние 5 сообщений для лучшего понимания запросов

🛠 Технологии:

Python 3.x - основной язык программирования
aiogram 3.0+ - фреймворк для работы с Telegram Bot API
Google Gemini API - генерация изображений с помощью ИИ
Supabase - облачная база данных PostgreSQL
Pillow (PIL) - обработка изображений
SQLite - локальная база данных (для старых версий)

🇰🇬 Проект жөнүндө

VanVan AI - бул искусственный интеллект колдонгон Telegram бот, тексттик сүрөттөмөлөр боюнча уникалдуу сүрөттөрдү жаратуу үчүн иштелип чыккан. Бот Google Gemini API колдонот.

✨ Негизги мүмкүнчүлүктөр:

🎨 Сүрөт жаратуу - тексттик сүрөттөмө боюнча уникалдуу сүрөттөрдү жаратуу
🖼️ Сүрөттү редакциялоо - стилди өзгөртүү, фонду алмаштыруу жана деталдарды кошуу
🎭 Сүрөттөрдү айкалыштыруу - эки сүрөттү бир сүрөткө бириктирүү
📱 Маркетплейс карточкаларын жаратуу - Wildberries, Ozon, Yandex Market үчүн товар карточкаларын жаратуу
👤 Модельдик сүрөттөр - портреттерди жана модельдик сүрөттөрдү жаратуу
💳 Жазылуу системасы - ар кандай тарифтик пландар
🤝 Рефералдык программа - досторду чакыруу жана бонус алуу
👨‍💼 Админ-панель - колдонуучуларды башкаруу, аналитика, жөнөтүүлөр
🧠 Контексттик эс - бот акыркы 5 билдирүүнү эстен чыгарбайт

🛠 Технологиялар:

Python 3.x - негизги программалоо тили
aiogram 3.0+ - Telegram Bot API менен иштөө үчүн фреймворк
Google Gemini API - ИИ менен сүрөт жаратуу
Supabase - булут PostgreSQL маалымат базасы
Pillow (PIL) - сүрөттөрдү иштетүү
SQLite - жергиликтүү маалымат базасы (эски версиялар үчүн)

📦 Установка и настройка / Орнотуу жана жөндөө

Требования / Талаптар:

Python 3.8 или выше
Telegram Bot Token
Google Gemini API Key
Supabase аккаунт (URL и API Key)

Шаг 1: Клонирование репозитория

git clone https://github.com/Koloda55SA/vanvan.git
cd vanvan

Шаг 2: Установка зависимостей

pip install -r requirements.txt

Шаг 3: Настройка переменных окружения

Создайте файл .env в корне проекта:

# Telegram Bot
BOT_TOKEN=your_telegram_bot_token
ADMIN_ID=your_admin_telegram_id
CHANNEL_ID=@your_channel_username

# Google Gemini
GEMINI_API_KEY=your_gemini_api_key

# Supabase
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

# Logging Bot (опционально)
LOG_BOT_TOKEN=your_log_bot_token
LOG_CHAT_ID=your_log_chat_id

# Instagram (опционально)
INSTAGRAM_URL=https://instagram.com/your_account
ADMIN_USERNAME=Badboy05y

Шаг 4: Настройка базы данных

Выполните SQL скрипт для создания таблиц:

# Если используете Supabase, выполните schema.sql в Supabase SQL Editor
# Или используйте локальную SQLite базу (для тестирования)

Шаг 5: Запуск бота

python main.py

🎯 Основные функции / Негизги функциялар

1. Генерация изображений / Сүрөт жаратуу

Пользователь отправляет текстовое описание, бот генерирует изображение с помощью Google Gemini API.

Пример промпта:

"Закат над океаном, золотые облака, фотореалистично"

2. Редактирование фото / Сүрөттү редакциялоо

Пользователь загружает фото и описывает желаемые изменения.

3. Создание карточек товаров / Товар карточкаларын жаратуу

Автоматическая генерация карточек для маркетплейсов с информацией о товаре.

4. Система подписок / Жазылуу системасы

Минимум - 149₽/7 дней (20 генераций/день)
Базовый - 399₽/30 дней (50 генераций/день)
Профессиональный - 799₽/30 дней (150 генераций/день)
Бесконечно - 1499₽/30 дней (100 генераций/час)

5. Реферальная программа / Рефералдык программа

Приглашайте друзей и получайте бонусные генерации за каждого приглашенного пользователя.

6. Админ-панель / Админ-панель

Управление пользователями
Создание ключей активации
Аналитика и статистика
Рассылка сообщений
Управление тарифами
Просмотр изображений пользователей

📁 Структура проекта / Проекттин структурасы

botkartochki/
├── main.py                 # Основной файл бота
├── bot_logic.py            # Логика бота (старая версия)
├── config.py               # Конфигурация и переменные окружения
├── models.py               # Модели данных
├── log_sender.py           # Отправка логов в Telegram
├── maintenance.py          # Режим технического обслуживания
├── requirements.txt        # Зависимости Python
├── schema.sql              # SQL схема базы данных
├── .env                    # Переменные окружения (создать вручную)
└── README.md               # Документация

🔧 Конфигурация / Жөндөө

Лимиты генераций / Генерация чектери

Бесплатные пользователи:

3 генерации в день
1 редактирование в день

Премиум пользователи:

Зависит от тарифного плана
Защита от банкротства (месячные лимиты)

Защита от банкротства / Банкротство коргоо

Система автоматически ограничивает количество генераций в месяц для каждого тарифа:

Free: 280 изображений/месяц
Минимум: 1400 изображений/месяц
Базовый: 2800 изображений/месяц
Профессиональный: 5600 изображений/месяц
Бесконечно: 7000 изображений/месяц

📊 База данных / Маалымат базасы

Таблицы:

users - информация о пользователях
subscription_plans - тарифные планы
keys - ключи активации
usage - статистика использования
referrals - реферальная программа
images - сохраненные изображения
channels - каналы для подписки
referral_settings - настройки реферальной программы

🚀 Развертывание / Деплой

Локальный запуск:

python main.py

Запуск на сервере:

Рекомендуется использовать:

systemd (Linux)
PM2 (Node.js процесс-менеджер)
Docker (контейнеризация)

Пример systemd сервиса:

[Unit]
Description=VanVan AI Telegram Bot
After=network.target

[Service]
Type=simple
User=your_user
WorkingDirectory=/path/to/botkartochki
ExecStart=/usr/bin/python3 main.py
Restart=always

[Install]
WantedBy=multi-user.target

📝 Команды бота / Боттун командалары

/start - Начать работу с ботом
/help - Справка по использованию
/stats - Статистика пользователя
/cancel - Отменить текущее действие

Кнопки меню:

🎨 Сгенерировать изображение
🖼️ Редактировать фото
🎭 Скрестить фото
👤 Профиль
🤝 Реферальная программа
🔑 Активировать ключ
💳 Купить подписку
❓ Помощь

🛡️ Безопасность / Коопсуздук

Проверка подписки на каналы
Система банов и мутов
Лимиты генераций
Защита от злоупотреблений
Логирование всех действий

📈 Аналитика / Аналитика

Админ-панель предоставляет:

Общее количество пользователей
Активные пользователи сегодня
Премиум пользователи
Общее количество генераций
Статистика рефералов
Новые пользователи за неделю

🤝 Вклад в проект / Проектке салым кошуу

Это дипломная работа, но предложения и замечания приветствуются!

📄 Лицензия / Лицензия

Тип лицензии: Proprietary (Собственническая)
Авторские права: © 2025 Абдырахманов Абдыкадыр
Использование: Только для образовательных целей (дипломная работа)

👤 Автор / Автор

Абдырахманов Абдыкадыр

Дипломная работа по разработке Telegram бота для генерации изображений с использованием искусственного интеллекта.

📞 Контакты / Байланыштар

Для вопросов и предложений:

Telegram: @Badboy05y

🙏 Благодарности / Ыраазычылык

Google за Gemini API
Разработчикам aiogram
Supabase за отличную платформу
Всем, кто тестировал и помогал в разработке

Версия: 1.0.0
Дата создания: 2025
Статус: ✅ Готов к использованию

Этот проект разработан как дипломная работа студентом Абдырахмановым Абдыкадыром.

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.gitignore		.gitignore
README.md		README.md
bot_logic.py		bot_logic.py
config.py		config.py
log_sender.py		log_sender.py
main.py		main.py
maintenance.py		maintenance.py
models.py		models.py
requirements.txt		requirements.txt
schema.sql		schema.sql

Folders and files

Latest commit

History

Repository files navigation

🤖 VanVan AI - Telegram бот для генерации изображений

📋 О проекте / Проект жөнүндө

🇷🇺 Описание проекта

✨ Основные возможности:

🛠 Технологии:

🇰🇬 Проект жөнүндө

✨ Негизги мүмкүнчүлүктөр:

🛠 Технологиялар:

📦 Установка и настройка / Орнотуу жана жөндөө

Требования / Талаптар:

Шаг 1: Клонирование репозитория

Шаг 2: Установка зависимостей

Шаг 3: Настройка переменных окружения

Шаг 4: Настройка базы данных

Шаг 5: Запуск бота

🎯 Основные функции / Негизги функциялар

1. Генерация изображений / Сүрөт жаратуу

2. Редактирование фото / Сүрөттү редакциялоо

3. Создание карточек товаров / Товар карточкаларын жаратуу

4. Система подписок / Жазылуу системасы

5. Реферальная программа / Рефералдык программа

6. Админ-панель / Админ-панель

📁 Структура проекта / Проекттин структурасы

🔧 Конфигурация / Жөндөө

Лимиты генераций / Генерация чектери

Защита от банкротства / Банкротство коргоо

📊 База данных / Маалымат базасы

Таблицы:

🚀 Развертывание / Деплой

Локальный запуск:

Запуск на сервере:

Пример systemd сервиса:

📝 Команды бота / Боттун командалары

Кнопки меню:

🛡️ Безопасность / Коопсуздук

📈 Аналитика / Аналитика

🤝 Вклад в проект / Проектке салым кошуу

📄 Лицензия / Лицензия

👤 Автор / Автор

📞 Контакты / Байланыштар

🙏 Благодарности / Ыраазычылык

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages