Ce projet est un assistant IA style ChatGPT capable de répondre à des questions sur la documentation d'un projet en utilisant une architecture RAG (Retrieval-Augmented Generation).
- /frontend : Application Next.js 15 (Tailwind CSS, Shadcn/ui).
- /backend : API FastAPI (Python) pour l'orchestration RAG, embeddings et intégration Gemini 1.5 Pro.
Le backend doit être lancé en premier car le frontend en a besoin pour récupérer les sources et l'historique.
cd backend
source venv/bin/activate
uvicorn app.main:app --reload --port 8000L'API sera disponible sur http://localhost:8000.
Dans un autre terminal :
cd frontend
npm run devL'application sera accessible sur http://localhost:3000.
Assurez-vous d'avoir les clés API nécessaires :
GOOGLE_API_KEY(pour Gemini)PROJECT_IDLOCATION
NEXT_PUBLIC_API_URL=http://localhost:8000NEXTAUTH_SECRET: Clé secrète NextAuth (voir section Sécurité).NEXTAUTH_URL=http://localhost:3000GOOGLE_CLIENT_ID: ID Client OAuth Google.GOOGLE_CLIENT_SECRET: Secret Client OAuth Google.
L'accès à l'application est protégé par NextAuth.js via le protocole Google SSO.
Exécutez cette commande dans votre terminal pour générer une clé robuste :
openssl rand -base64 32Copiez le résultat dans la variable NEXTAUTH_SECRET du fichier .env.local.
- Allez sur Google Cloud Console.
- Dans API et services > Identifiants, cliquez sur Créer des identifiants > ID de client OAuth.
- Choisissez Application Web.
- Origines JavaScript autorisées :
http://localhost:3000 - URIs de redirection autorisés :
http://localhost:3000/api/auth/callback/google
- Origines JavaScript autorisées :
- Récupérez le Client ID et le Client Secret et ajoutez-les au fichier
.env.local.
Pour plus de détails sur la conception et les fonctionnalités, consultez instruction.md.