zinthejunior/kossi-chat

# Kossi Chat - AI Assistant pour CAEB Natitingou Interface de chat alimentée par l'IA pour la Bibliothèque CAEB Natitingou, construite avec Next.js 15 et FastAPI. ## Fonctionnalités - 💬 Chat en temps réel avec assistance IA - 📚 Recherche dans le catalogue de livres - 🔍 Recherche Web intégrée - 📖 Recommandations personnalisées - 🌍 Support multilingue - 🚀 Interface moderne et responsive ## Architecture - **Frontend**: Next.js 15 avec React 19, Tailwind CSS - **Backend**: FastAPI (Python) - **IA**: OpenRouter API (LLMs) - **Base de données**: PostgreSQL (partagée avec CAEB) ## Technologies ``` Frontend: - Next.js 15 - React 19 - TypeScript - Tailwind CSS - Lucide Icons Backend: - FastAPI - SQLAlchemy - Pydantic - PostgreSQL ``` ## Installation ### Prérequis - Node.js 18+ - Python 3.9+ - PostgreSQL ### Setup Frontend ```bash cd Kossi npm install cp .env.example .env.local # Remplir les variables d'environnement npm run dev ``` ### Setup Backend ```bash cd Kossi python -m venv venv source venv/bin/activate # ou `venv\Scripts\activate` sur Windows pip install -r requirements.txt cp fastapi_kossi/.env.example fastapi_kossi/.env # Remplir les variables d'environnement python -m uvicorn fastapi_kossi.main:app --reload --port 8001 ``` ## Variables d'Environnement ### Frontend (.env.local) ```env NEXT_PUBLIC_KOSSI_API=localhost NEXT_PUBLIC_CAEB_API=caeb-backend.onrender.com ``` ### Backend (fastapi_kossi/.env) ```env BACKEND_API_URL=caeb-backend.onrender.com OPENROUTER_API_KEY=sk-or-v1-... CORS_ORIGINS=http://localhost:3000,https… ``` ## Développement ```bash # Terminal 1 - Frontend Next.js npm run dev:frontend # Terminal 2 - Backend FastAPI npm run dev:backend # Ou les deux ensemble: npm run dev ``` Ouvrir localhost ## Build & Déploiement ### Frontend Vercel ```bash npm run build npm start ``` ### Backend Render/Railway - Connecter le repository GitHub - Configurer les variables d …