Skip to content

lulu960/gameforge

Repository files navigation

GameForge — Plateforme Django IA

GameForge est une plateforme web Django permettant de générer des concepts de jeux vidéo avec l'aide de l'IA (Hugging Face, Diffusers, Transformers, etc.).

🚀 Installation

# 1) Créer un environnement virtuel
python -m venv .venv
.venv\Scripts\activate  # Windows
# source .venv/bin/activate  # macOS/Linux

# 2) Installer les dépendances
pip install -r requirements.txt

# 3) Appliquer les migrations
python manage.py makemigrations
python manage.py migrate

# 4) (Optionnel) Créer un superuser pour l'admin
python manage.py createsuperuser

# 5) Lancer le serveur
python manage.py runserver

Accédez à http://127.0.0.1:8000/

## 🧩 Fonctionnalités principales
- Authentification (inscription, connexion, déconnexion)
- Création guidée de jeux vidéo avec formulaire
- Génération IA : univers, scénario (3 actes), lieux, personnages, images conceptuelles
- Exploration libre : génération aléatoire, sauvegarde si connecté
- Tableau de bord personnel avec recherche, filtrage, et gestion des favoris (Star)
- Système de Star (favoris) sur chaque jeu, style GitHub
- Affichage du nombre de stars sur chaque jeu (dashboard et jeux publics)
- Toggle Public/Privé pour chaque jeu
- UI moderne avec Tailwind CSS
- Limite quotidienne de génération par utilisateur (modifiable via `GAMEFORGE_DAILY_LIMIT`)
- Page de paramètres du compte (modification email, username)

## 🎮 Modèle de données
- **Game** : titre, genre (30+ genres), ambiance, mots-clés, références, univers, histoire, lieux, images conceptuelles, visibilité
- **Character** : nom, rôle, capacités, motivation
- **Favorite** : favoris utilisateur (Star)

## 🤖 Génération IA
- Utilise Hugging Face InferenceClient pour générer le texte et les images (Stable Diffusion, CLIP, etc.)
- Prompts enrichis et aléatoires pour chaque génération
- Harmonisation des noms de personnages dans le scénario
- Images conceptuelles générées avec contexte du jeu

## 📦 Dépendances principales
- Django
- Pillow
- requests
- python-dotenv
- torch, torchvision, torchaudio (GPU support)
- diffusers, transformers, huggingface_hub

## 🖼️ Images conceptuelles
- Pour la production : configurez Hugging Face / Stable Diffusion

## 🔒 Authentification & Limites
- Accès à l'exploration et à la sauvegarde uniquement pour les utilisateurs connectés
- Limite quotidienne configurable via variable d'environnement

## 📝 Exemple d'utilisation
- Créez un compte
- Explorez ou créez un jeu via le formulaire
- Visualisez le scénario, les personnages, les images générées
- Ajoutez des stars (favoris) directement depuis le dashboard
- Filtrez et recherchez vos jeux
- Modifiez vos infos de compte

## 📄 Licence
Projet pédagogique — libre d'utilisation et de modification.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published