GUIDE_DEMARRAGE.md 3.8 KB

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.

2. Python 3.10 ou 3.11 (recommandé)


Option A : Tout lancer avec Docker (le plus simple)

Tout (app + PostgreSQL + Ollama) tourne dans Docker.

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

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 :

docker ps

Vous devez voir un conteneur postgres avec le port 5432.

Étape 2 : Créer l’environnement Python

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) :

.\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

.\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

.\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