Skip to content

README.md

Latest commit

 

History

History
154 lines (116 loc) · 4.02 KB

README.md

File metadata and controls

154 lines (116 loc) · 4.02 KB

Générateur de Proverbes Inspirants

Une application web moderne qui génère des proverbes inspirants avec synthèse vocale, utilisant l'IA Google Gemini et ElevenLabs.

🚀 Fonctionnalités

  • ✨ Génération de proverbes inspirants avec Google Gemini
  • 🔊 Synthèse vocale premium avec ElevenLabs
  • 🌍 Support multilingue (Français/Anglais)
  • ❤️ Système de favoris avec sauvegarde locale
  • 📱 Design responsive et moderne
  • 🔗 Partage sur réseaux sociaux

📋 Prérequis

  • Node.js (version 18 ou supérieure)
  • Clé API Google Gemini
  • Clé API ElevenLabs

🛠️ Installation

  1. Cloner le projet
git clone <votre-repo>
cd proverbs-generator
  1. Installer les dépendances
npm install
  1. Configurer les variables d'environnement
# Copier le fichier d'exemple
cp .env.example .env

# Éditer le fichier .env et ajouter vos clés API
  1. Ajouter vos clés API dans le fichier .env
GEMINI_API_KEY=votre-clé-gemini-ici
ELEVENLABS_API_KEY=votre-clé-elevenlabs-ici
PORT=3001

🚀 Démarrage

# Démarrer le serveur de développement (frontend + backend)
npm run dev

L'application sera accessible sur :

📁 Structure du projet

proverbs-generator/
├── src/                    # Code React (Frontend)
│   ├── App.tsx            # Composant principal
│   ├── main.tsx           # Point d'entrée React
│   └── index.css          # Styles Tailwind
├── server/                # Serveur Express (Backend)
│   └── index.js           # API REST
├── .env                   # Variables d'environnement (à créer)
├── .env.example          # Exemple de configuration
└── package.json          # Dépendances et scripts

🔑 Obtenir les clés API

Google Gemini API Key

  1. Aller sur Google AI Studio
  2. Créer un compte Google ou se connecter
  3. Cliquer sur "Create API Key"
  4. Copier votre clé API

ElevenLabs API Key

  1. Aller sur ElevenLabs
  2. Créer un compte ou se connecter
  3. Aller dans "Profile" → "API Key"
  4. Copier votre clé API

🛠️ Scripts disponibles

npm run dev          # Démarrer frontend + backend
npm run dev:client   # Démarrer seulement le frontend
npm run dev:server   # Démarrer seulement le backend
npm run build        # Construire pour la production
npm run preview      # Prévisualiser la build de production

🔧 Configuration

Voix ElevenLabs

Les voix utilisées par défaut :

  • Français : Adam (pNInz6obpgDQGcFmaJgB)
  • Anglais : Rachel (21m00Tcm4TlvDq8ikWAM)

Vous pouvez modifier les IDs de voix dans server/index.js.

Modèle Gemini

Par défaut, l'application utilise gemini-pro. Vous pouvez modifier le modèle dans server/index.js si nécessaire.

🚨 Sécurité

  • ⚠️ Ne jamais commiter le fichier .env avec vos vraies clés API
  • 🔒 Les clés API sont stockées côté serveur uniquement
  • 🛡️ Le frontend ne peut pas accéder directement aux clés API

📱 Fonctionnalités

Génération de proverbes

  • Proverbes uniques générés par Gemini AI
  • Contenu adapté à tout public
  • Support français et anglais

Synthèse vocale

  • Voix naturelles et chaleureuses
  • Lecture instantanée
  • Voix différentes selon la langue

Gestion des favoris

  • Sauvegarde locale dans le navigateur
  • Affichage de la date d'ajout
  • Suppression facile des favoris

Partage social

  • Twitter, Facebook, LinkedIn
  • Copie dans le presse-papier
  • URL de partage automatique

🐛 Dépannage

Erreur "API key not configured"

Vérifiez que vos clés API sont correctement définies dans le fichier .env.

Erreur de connexion API

Vérifiez votre connexion internet et que vos clés API sont valides.

Port déjà utilisé

Modifiez le port dans le fichier .env :

PORT=3002

📄 Licence

MIT License - voir le fichier LICENSE pour plus de détails.