GameForge¶

AI Game Dev Toolkit — семь ИИ-инструментов для инди-разработчиков, студий и моддеров: уровни, квесты, текстуры, персонажи, звук, плейтест и локализация.

Версия продукта

Текущая версия API: 1.2.0. Прод: https://gameforge.website.

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

Возможность	Описание
Level Designer	Тайлмап JSON + превью на canvas по текстовому брифу
Quest Generator	Квесты, диалоги и ветвления в JSON
Texture Upscaler	Апскейл 2× / 4× (Real-ESRGAN или PIL mock)
Character Creator	Концепт-арты персонажей по описанию
Sound Designer	SFX / музыка / голос (WAV/MP3)
Playtester	QA-отчёт по дизайн-доку
Localization	Переводы JSON/CSV со словарём
Проекты и экспорт	Группировка ассетов и ZIP
Команда	Организации Studio, инвайты, роли
Тарифы	Free / Indie / Studio / Enterprise (on-prem)

Быстрый старт¶

git clone https://github.com/valera7623/GameForge.git
cd gameforge
cp .env.example .env
docker compose up -d --build
docker compose exec api python scripts/seed_db.py

Сервис	URL
Фронтенд	http://localhost:3000
API	http://localhost:8000
Swagger (не production)	http://localhost:8000/docs
MinIO	http://localhost:9001

Локальные демо-аккаунты (после seed — не для продакшена):

User: demo@gamedev.ai / demo123456
Admin: admin@gamedev.ai / admin123456

Production

Seed запрещён при APP_ENV=production. Демо-паролей на VPS быть не должно.

Архитектура (кратко)¶

flowchart LR
  User --> Caddy
  Caddy --> FrontendNginx
  FrontendNginx --> API
  API --> Postgres
  API --> Redis
  API --> MinIO
  Worker --> Redis
  Worker --> Postgres
  Worker --> MinIO

Карта документации¶

Начало работы — установка и первая генерация
Архитектура — компоненты и потоки
Руководство пользователя — UI, инструменты, биллинг
Администрирование — чеклист прода, мониторинг, бэкапы
Для разработчиков — API и авторизация
Развёртывание — Docker, VPS, troubleshooting