Effi/docs/guide-installation-effioc.md

Guide Pas à Pas - Git et effi-ocr

Ce guide va te permettre de :

1. Récupérer les mises à jour depuis Gitea
2. Installer effi-ocr sur effi-server

---

AVANT DE COMMENCER

Tu as besoin de savoir :

• Tu es connecté en SSH sur effi-server (192.168.1.27)
• Ton nom d'utilisateur : effi

---

PARTIE 1 : Récupérer les mises à jour (git pull)

Étape 1.1 : Vérifier le dossier

ls -la ~/effi

Attendu : Tu dois voir des fichiers comme docker-compose.yml, effi-ocr/, etc.

Si erreur : "No such file or directory" → Va à la PARTIE 3

Étape 1.2 : Faire la mise à jour

cd ~/effi
git pull origin main

Attendu : Ça affiche des messages et finit par "Already up to date" ou récupère des fichiers.

---

PARTIE 2 : Installer effi-ocr sur effi-server

Étape 2.1 : Vérifier Docker

docker --version
docker compose version

Attendu : Les deux commandes affichent une version (ex: "Docker version 24.0.7")

Si erreur : Docker n'est pas installé → Dis-moi !

Étape 2.2 : Vérifier que le fichier docker-compose existe

ls -la ~/effi/docker-compose-ocr.yml

Attendu : Le fichier existe

Étape 2.3 : Lancer effi-ocr

cd ~/effi
docker compose -f docker-compose-ocr.yml up -d --build

Attendu : Docker télécharge des fichiers et démarre le service

Étape 2.4 : Vérifier que ça marche

curl http://localhost:8300/health

Attendu : {"status":"healthy","service":"effi-ocr",...}

Étape 2.5 : Vérifier dans Docker

docker ps | grep effi-ocr

Attendu : Une ligne avec "effi-ocr" et statut "Up"

---

PARTIE 3 : Si le dossier effi n'existe pas (clone)

Étape 3.1 : Cloner le repo

cd ~
git clone https://gitea.folzocorp.fr/Folzo/effi.git

Attendu : Ça télécharge les fichiers

Étape 3.2 : Continuer depuis l'Étape 2

Refais les étapes 2.1 à 2.5

---

PARTIE 4 : Configurer OpenWebUI

Étape 4.1 : Modifier l'URL OCR dans OpenWebUI

1. Ouvre dans ton navigateur : http://192.168.1.27:3000
2. Clique sur ton profil (en bas à gauche)
3. Clique Admin Panel
4. Clique Settings → Environment Variables
5. Cherche OCR_URL
6. Change la valeur pour : http://host.docker.internal:8300
7. Clique Save

Étape 4.2 : Recréer le Tool OCR (si nécessaire)

1. Admin Panel → Tools
2. Cherche "OCR" existant et supprime-le
3. Clique Create Tool
4. Name : effi-ocr
5. ID : effi_ocr
6. Description : Extrait le texte des images avec OCR
7. Copie le code Python depuis : ~/effi/effi-ocr/TOOL-OPENWEBUI.md
8. Clique Save

---

PARTIE 5 : Tester

Étape 5.1 : Test effi-ocr directement

curl http://localhost:8300/health

Étape 5.2 : Test dans OpenWebUI

1. Ouvre http://192.168.1.27:3000
2. Active le tool OCR dans la conversation
3. Envoie une image avec le prompt :

Utilise effi-ocr pour extraire le texte de cette image

---

COMMANDE UTILES

# Voir les logs d'effi-ocr
docker logs effi-ocr -f

# Arrêter effi-ocr
docker compose -f ~/effi/docker-compose-ocr.yml down

# Redémarrer effi-ocr
docker restart effi-ocr

# Mettre à jour (après git pull)
docker compose -f ~/effi/docker-compose-ocr.yml up -d --build

---

SI ÇA NE MARCHE PAS

Erreur "Fichier non trouvé"

→ effi-ocr n'est pas sur le même serveur qu'OpenWebUI

Erreur de connexion

→ Vérifier que effi-ocr tourne : docker ps | grep effi-ocr

OCR URL incorrecte

→ Vérifier dans OpenWebUI → Settings → Environment Variables

---

Document créé: Avril 2026