Rokhaya2002/samaAgent

Ndimbal_Wolof # Ndimbal Wolof - Assistant Virtuel Sénégalais Assistant virtuel intelligent en langue wolof, propulsé par Google Gemini. ## 🚀 Installation ### Prérequis - Node.js 20 ou supérieur - npm ou yarn ### Configuration 1. **Clonez le repository** ```bash git clone github.com cd samaAgent ``` 2. **Installez les dépendances** ```bash npm install ``` 3. **Configurez votre clé API** a. Copiez le fichier d'exemple : ```bash cp .env.example .env ``` b. Obtenez une clé API Gemini : - Allez sur aistudio.google.com - Créez une nouvelle clé API c. Modifiez le fichier `.env` : ```env VITE_API_KEY=VOTRE_CLE_API_ICI ``` 4. **Lancez le serveur de développement** ```bash npm run dev ``` 5. **Ouvrez votre navigateur** - Allez sur localhost ## 🔒 Sécurité ⚠️ **IMPORTANT** : Ne commitez JAMAIS le fichier `.env` sur Git! Le fichier `.env` contient votre clé API personnelle et ne doit jamais être partagé publiquement. ## 📦 Build de Production ```bash npm run build npm run preview ``` ## 🌟 Fonctionnalités - ✅ Chat en temps réel avec streaming - ✅ Support des messages vocaux - ✅ Interface moderne et responsive - ✅ PWA (Progressive Web App) - Installable - ✅ Mode hors ligne (interface uniquement) - ✅ Animations fluides - ✅ Design professionnel avec glassmorphisme ## 🛠️ Technologies - **Frontend** : React 19, TypeScript - **Build** : Vite 6 - **AI** : Google Gemini API (@google/genai) - **Styling** : Tailwind CSS - **PWA** : vite-plugin-pwa ## 📱 Installation PWA L'application peut être installée comme une app native : ### Desktop (Chrome/Edge) 1. Cliquez sur l'icône d'installation dans la barre d'adresse 2. Confirmez l'installation ### Mobile (Android) 1. Menu → "Ajouter à l'écran d'accueil" ### Mobile (iOS) 1. Partager → "Sur l'écran d'accueil" ## 🤝 Contribution Les contributions sont les bienvenues! Veuillez : 1. Fork le projet 2. Créez une branche (`git checkout -b feature/AmazingFeature`) 3. Commitez v …