Assistant AI - Déploiement
Problèmes identifiés et corrigés
1. Clés API hardcodées ✅
- Problème : Clé SerpAPI hardcodée dans le code
- Solution : Utilisation des variables d'environnement
2. Configuration de développement ✅
- Problème :
debug=True et localhost en production
- Solution : Configuration conditionnelle basée sur les variables d'environnement
3. Dépendances lourdes ✅
- Problème : Toutes les dépendances de développement incluses
- Solution :
requirements-prod.txt optimisé
4. Pas de configuration Docker ✅
- Problème : Aucun fichier de déploiement
- Solution : Dockerfile et docker-compose.yml créés
🚀 Déploiement Manuel
Option 1 : Docker Compose (Recommandé)
Vérifier Docker
docker --version
docker-compose --version
Configurer les variables d'environnement
cp env.example .env
# Éditer .env avec vos vraies valeurs
Créer les dossiers nécessaires
mkdir uploads data
Lancer avec Docker Compose
docker-compose up -d
Option 2 : Render.com
- Connecter votre repo GitHub à Render
- Configurer les variables d'environnement dans l'interface Render
- Déployer automatiquement
Option 3 : VPS Privé
Installer Docker sur votre VPS
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
Cloner et déployer
git clone <votre-repo>
cd assistant_ai
docker-compose up -d
Variables d'environnement requises
# Obligatoires
SERPAPI_KEY=your_serpapi_key_here
WIKI_USERNAME=your_wiki_username
WIKI_PASSWORD=your_wiki_password
# Optionnelles (valeurs par défaut)
FLASK_ENV=production
FLASK_DEBUG=false
FLASK_HOST=0.0.0.0
FLASK_PORT=5000
OLLAMA_HOST=http://ollama:11434
UPLOAD_FOLDER=uploads
MAX_CONTENT_LENGTH=16777216
Architecture
- Flask App : Port 5000
- Ollama : Port 11434 (pour les modèles LLM)
- Volumes persistants : uploads/, data/, ollama_data
Sécurité
- ✅ Clés API externalisées
- ✅ Mode debug désactivé en production
- ✅ Limite de taille de fichier configurée
- ✅ Variables d'environnement pour les secrets
Monitoring
- Logs disponibles via
docker-compose logs -f
- Métriques d'application dans les logs Flask
- Scheduler APScheduler pour les mises à jour automatiques
📋 Instructions détaillées
Pour des instructions complètes, consultez :
SETUP_MANUAL.md - Guide de setup manuel
DEPLOYMENT.md - Guide de déploiement complet
PROJECT_STRUCTURE.md - Structure du projet