GameForge¶
AI Game Dev Toolkit — seven AI-powered tools for indie developers, studios, and modders: levels, quests, textures, characters, sound, playtesting, and localization.
Product version
Current API version: 1.2.0. Production site: https://gameforge.website.
What GameForge Does¶
| Capability | Description |
|---|---|
| Level Designer | Tilemap JSON + canvas preview from a text brief |
| Quest Generator | Quests, dialogues, and branching narrative JSON |
| Texture Upscaler | 2× / 4× image upscale (Real-ESRGAN or PIL mock) |
| Character Creator | Character concept images from descriptions |
| Sound Designer | SFX / music / voice clips (WAV/MP3) |
| Playtester | Automated QA-style reports for game design docs |
| Localization | JSON/CSV translations with glossary support |
| Projects & export | Group assets per project and download a ZIP |
| Team seats | Studio plan organizations, invites, roles |
| Plans | Free / Indie / Studio / Enterprise (on-prem) |
Quick Start¶
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
| Service | URL |
|---|---|
| Frontend | http://localhost:3000 |
| API | http://localhost:8000 |
| Swagger (non-production) | http://localhost:8000/docs |
| MinIO console | http://localhost:9001 |
Local demo accounts (after seed — never use in production):
- User:
demo@gamedev.ai/demo123456 - Admin:
admin@gamedev.ai/admin123456
Production
Seed is refused when APP_ENV=production. Demo passwords must not exist on a live VPS.
Architecture Overview¶
flowchart LR
User --> Caddy
Caddy --> FrontendNginx
FrontendNginx --> API
API --> Postgres
API --> Redis
API --> MinIO
Worker --> Redis
Worker --> Postgres
Worker --> MinIO
Documentation Map¶
- Getting Started — install, env, first generation
- Architecture — components and data flow
- User Guide — dashboard, tools, team, billing
- Admin Guide — production checklist, monitoring, backups
- Developer Guide — API, auth, tool endpoints
- Deployment — Docker, VPS, troubleshooting