181 lines
3.6 KiB
Markdown
181 lines
3.6 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
ls -la ~/effi/docker-compose-ocr.yml
|
|
```
|
|
|
|
**Attendu** : Le fichier existe
|
|
|
|
### Étape 2.3 : Lancer effi-ocr
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
curl http://localhost:8300/health
|
|
```
|
|
|
|
**Attendu** : `{"status":"healthy","service":"effi-ocr",...}`
|
|
|
|
### Étape 2.5 : Vérifier dans Docker
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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*
|