# Guide de démarrage – Reprise du projet Agent Docker Ce guide vous permet de reprendre ce projet développé par quelqu'un d'autre et de le lancer avec **PostgreSQL**. --- ## Prérequis à installer ### 1. Docker Desktop (obligatoire pour PostgreSQL) PostgreSQL tourne dans un conteneur Docker. Sans Docker, vous ne pouvez pas lancer la base. - **Télécharger** : https://www.docker.com/products/docker-desktop/ - **Installer** puis **redémarrer** le PC - Vérifier : ouvrir PowerShell et taper `docker --version` ### 2. Python 3.10 ou 3.11 (recommandé) - **Télécharger** : https://www.python.org/downloads/ - À l’installation, cocher **"Add Python to PATH"** - Vérifier : `py --version` --- ## Option A : Tout lancer avec Docker (le plus simple) Tout (app + PostgreSQL + Ollama) tourne dans Docker. ```powershell cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\agent_docker_reprise de nadine\agent_docker" # 1. Créer le fichier .env (s'il n'existe pas) copy .env.example .env # 2. Éditer .env et remplir au minimum : # - WIKI_USERNAME # - WIKI_PASSWORD # - SCW_API_KEY # 3. Lancer tous les services docker-compose up --build ``` L’application sera sur **http://localhost:5000**. --- ## Option B : Lancer l’app en local + PostgreSQL dans Docker Utile pour le développement et le debug. ### Étape 1 : Démarrer PostgreSQL ```powershell cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\agent_docker_reprise de nadine\agent_docker" # Lancer uniquement PostgreSQL en arrière-plan docker-compose up -d postgres ``` Vérifier que PostgreSQL tourne : ```powershell docker ps ``` Vous devez voir un conteneur `postgres` avec le port `5432`. ### Étape 2 : Créer l’environnement Python ```powershell cd "c:\Users\USER\Documents\Intersel - Livinweb\dev\agent_docker_reprise de nadine\agent_docker" # Créer le venv py -m venv venv # Activer le venv .\venv\Scripts\Activate.ps1 # Installer les dépendances (inclut psycopg2 pour PostgreSQL) .\install_local.ps1 ``` Si erreur avec `psycopg2` (souvent sur Python 3.13) : ```powershell .\install_local.ps1 -SkipPsycopg ``` Dans ce cas, l’app utilisera SQLite au lieu de PostgreSQL. ### Étape 3 : Configurer le fichier .env Le fichier `.env` doit contenir au minimum : ``` DATABASE_URL=postgresql://postgres:postgres@localhost:5432/agent SECRET_KEY=votre-secret-key-changez-en-production ``` Identifiants PostgreSQL par défaut : - **Utilisateur** : `postgres` - **Mot de passe** : `postgres` - **Base** : `agent` - **Port** : `5432` ### Étape 4 : Lancer l’application ```powershell .\run_local.ps1 ``` L’app sera sur **http://localhost:5000**. --- ## Résumé des commandes utiles | Action | Commande | |--------|----------| | Démarrer PostgreSQL seul | `docker-compose up -d postgres` | | Arrêter PostgreSQL | `docker-compose stop postgres` | | Voir les conteneurs | `docker ps` | | Lancer l’app en local | `.\run_local.ps1` | | Tout lancer (Docker) | `docker-compose up --build` | --- ## En cas de problème ### "Connection refused" ou erreur de connexion à la base - Vérifier que PostgreSQL tourne : `docker ps` - Si absent : `docker-compose up -d postgres` - Attendre 10–15 secondes avant de relancer l’app ### Erreur psycopg2 sur Windows ```powershell .\install_local.ps1 -SkipPsycopg ``` L’app utilisera SQLite (fichier local) au lieu de PostgreSQL. ### Port 5432 déjà utilisé Une autre instance de PostgreSQL est peut-être installée sur la machine. Vous pouvez : - Arrêter l’autre PostgreSQL, ou - Modifier le port dans `docker-compose.yml` (ex. `5433:5432`) --- ## Structure du projet - `src/` – Code source de l’application Flask - `config.py` – Configuration (base, API, etc.) - `.env` – Variables d’environnement (ne pas commiter) - `docker-compose.yml` – Définition des services (app, postgres, ollama) - `requirements.txt` – Dépendances Python