Effi/effi-ocr-legacy/TROUBLESHOOTING.md

Dépannage effi-OCR

Problèmes Connus

1. "Fichier non trouvé" - Erreur Common

Symptôme :

Erreur: Fichier non trouvé pour l'ID: page_image.jpg (cherché dans /app/backend/data/uploads/)

Cause : effi-ocr est sur une autre machine que OpenWebUI. Les chemins de fichiers ne sont pas partagés.

Solution : Installer effi-ocr sur le MÊME serveur qu'OpenWebUI (effi-server 192.168.1.27)

---

2. effi-ocr loop / se bloque

Symptôme : Le modèle répète "call the tool call the tool..." en boucle.

Causes possibles :

• Tool mal configuré dans OpenWebUI
• URL OCR_URL incorrecte
• Le modèle a un problème avec le tool calling

Solutions :

1. Vérifier que OCR_URL pointe vers le bon serveur
2. Recréer le tool OCR dans OpenWebUI
3. Désactiver Sub Agent/Planner Agent temporairement

---

3. OCR retourne du texte vide

Causes possibles :

• Image de mauvaise qualité
• Langue incorrecte (utiliser fra+eng)
• Prétraitement désactivé

Solutions :

1. Tester avec une image plus claire
2. Utiliser lang=fra+eng pour documents mixtes
3. Activer le prétraitement

---

Checklist Diagnostic

• effi-ocr tourne sur le port 8300
• OCR_URL est correct dans OpenWebUI
• effi-ocr est sur le MÊME serveur qu'OpenWebUI
• Le tool OCR est correctement créé dans Admin → Tools
• Le fichier uploadé existe dans /app/backend/data/uploads/

---

Commandes de Test

Vérifier effi-ocr (sur le serveur où il tourne)

curl http://localhost:8300/health

Tester OCR avec une image

curl -X POST -F "file=@test.jpg" -F "lang=fra" http://localhost:8300/ocr

Vérifier les fichiers uploadés (OpenWebUI)

ls -la /app/backend/data/uploads/

---

Dernière mise à jour: Avril 2026