Windows :
# Via winget (recommandé)
winget install Docker.DockerDesktop
# Ou téléchargement manuel
# https://www.docker.com/products/docker-desktop
Linux :
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
# Copier le fichier d'exemple
cp env.example .env
# Éditer avec vos vraies valeurs
notepad .env # Windows
nano .env # Linux
Variables obligatoires :
SERPAPI_KEY=your_serpapi_key_here
WIKI_USERNAME=your_wiki_username
WIKI_PASSWORD=your_wiki_password
# Script automatique (Linux/Mac)
chmod +x scripts/setup.sh
./scripts/setup.sh
# Ou manuellement
docker-compose up -d
# Vérifier les services
docker-compose ps
# Voir les logs
docker-compose logs -f
# Tester l'application
curl http://localhost:5000/
Choisir un VPS :
Spécifications minimales :
# Script de déploiement
chmod +x scripts/deploy-vps.sh
./scripts/deploy-vps.sh <vps-ip> <user> <ssh-key>
# Exemple
./scripts/deploy-vps.sh 192.168.1.100 root ~/.ssh/id_rsa
# Connexion au VPS
ssh user@vps-ip
# Installation de Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
# Installation de Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
# Cloner le projet
git clone <your-repo>
cd assistant-ai
# Configurer les variables
cp env.example .env
nano .env
# Déployer
docker-compose up -d
# Exécuter les tests de déploiement
python tests/test_deployment.py
# Logs en temps réel
docker-compose logs -f
# Statut des services
docker-compose ps
# Utilisation des ressources
docker stats
Les services incluent des healthchecks automatiques :
http://localhost:5000/http://localhost:11434/api/tags1. Docker ne démarre pas
# Redémarrer Docker Desktop
# Ou sur Linux
sudo systemctl restart docker
2. Ports déjà utilisés
# Vérifier les ports
netstat -tulpn | grep :5000
# Changer les ports dans docker-compose.yml
3. Variables d'environnement manquantes
# Vérifier le fichier .env
cat .env
# S'assurer que toutes les variables sont définies
4. Modèles Ollama non téléchargés
# Télécharger le modèle
docker exec -it assistant-ai-ollama-1 ollama pull llama3
| Critère | Local | Render | VPS |
|---|---|---|---|
| Coût | Gratuit | 7$/mois | 5-50€/mois |
| Complexité | Simple | Très simple | Moyenne |
| Contrôle | Total | Limité | Total |
| Performance | Moyenne | Bonne | Excellente |
| Sécurité | Basique | Bonne | Excellente |
| Maintenance | Manuelle | Automatique | Manuelle |
Pour débuter : Option 1 (Local) → Option 2 (Render) Pour production : Option 3 (VPS) avec les améliorations de sécurité