SETUP_MANUAL.md 2.7 KB

Setup Manuel - Assistant AI

📁 Création de la structure des dossiers

Exécutez ces commandes manuellement dans votre terminal :

1. Créer les dossiers src

mkdir src\api
mkdir src\static
mkdir src\templates
mkdir src\models
mkdir src\utils

2. Créer les dossiers de données

mkdir uploads
mkdir data

3. Créer les dossiers de scripts et tests

mkdir scripts
mkdir tests

📄 Déplacer les fichiers

4. Déplacer les fichiers principaux

move app.py src\
move index.html src\templates\
move ocr.py src\utils\
move processing.py src\utils\
move VLM.py src\models\
move agent_ai src\

5. Créer les fichiers init.py

echo # Package src pour l'application Assistant AI > src\__init__.py
echo # Utilitaires pour l'application > src\utils\__init__.py
echo # Modèles ML pour l'application > src\models\__init__.py
echo # API routes pour l'application > src\api\__init__.py

⚙️ Configuration

6. Copier le fichier d'environnement

copy env.example .env

7. Éditer le fichier .env

Ouvrez le fichier .env et configurez vos variables :

notepad .env

Variables obligatoires :

SERPAPI_KEY=your_serpapi_key_here
WIKI_USERNAME=your_wiki_username
WIKI_PASSWORD=your_wiki_password

🚀 Déploiement

8. Vérifier Docker

docker --version
docker-compose --version

9. Lancer l'application

docker-compose up -d

10. Vérifier le statut

docker-compose ps

11. Voir les logs

docker-compose logs -f

🧪 Tests

12. Tester l'application

python tests/test_deployment.py

📊 Monitoring

13. Vérifier les services

# Statut des conteneurs
docker-compose ps

# Logs en temps réel
docker-compose logs -f

# Utilisation des ressources
docker stats

🆘 En cas de problème

Docker ne démarre pas

# Redémarrer Docker Desktop
# Ou sur Linux
sudo systemctl restart docker

Ports déjà utilisés

# Vérifier les ports
netstat -tulpn | grep :5000

Variables d'environnement manquantes

# Vérifier le fichier .env
type .env

✅ Vérification finale

Une fois tout configuré, votre application devrait être accessible sur :

  • Local : http://localhost:5000
  • Interface : Interface web pour uploader des fichiers
  • API : Endpoints pour l'authentification et les questions

📝 Notes importantes

  • Tous les fichiers de configuration sont déjà créés
  • Les scripts de déploiement sont prêts
  • La structure est optimisée pour la production
  • Les tests sont inclus

Votre projet est maintenant prêt pour le déploiement ! 🎉