Effi/docs/04-depannage

🔧 Dépannage - Index

Vue d'ensemble

Cette section regroupe les problèmes courants rencontrés avec Effi et leurs solutions.

---

Problèmes par catégorie

🖥️ GPU AMD ROCm

• hipErrorInvalidDeviceFunction
• float16 not supported on CPU backend
• Build CTranslate2 pour gfx1100
• ROCm non détecté

🌐 Réseau et Ports

• Conflits de ports
• Wake-on-LAN non fonctionnel
• Interface réseau qui tombe
• Erreurs de connexion entre machines

💾 Mémoire et Stockage

• Souvenirs qui ne s'enregistrent pas
• Souvenirs non injectés
• Erreurs SQLite
• Base CouchDB inaccessible

🐳 Docker

• Conteneurs qui redémarrent en boucle
• Erreurs de permissions
• Volumes non persistants
• Images qui ne buildent pas

🎤 Audio

• STT qui ne répond pas
• TTS silencieux
• Latence excessive
• Erreurs de transcription

---

Diagnostic rapide

Commandes de base

# Vérifier l'état des conteneurs
docker compose ps

# Voir les logs d'un service
docker compose logs [service]

# Vérifier l'utilisation des ressources
docker stats

# Tester les connexions réseau
curl http://192.168.1.27:3000  # OpenWebUI
curl http://192.168.1.11:11434/api/tags  # Ollama
curl http://192.168.1.11:8200/v1/models  # STT
curl http://192.168.1.11:8100/v1/models  # TTS

Logs importants

# Logs OpenWebUI (problèmes généraux)
docker logs open-webui --tail 100

# Logs avec filtre mémoire
docker logs open-webui --tail 50 | grep -iE "memory|saved|added"

# Logs speaches (STT)
docker logs speaches-stt

# Logs wol-proxy
docker logs wol-proxy

---

Checklist de diagnostic

Problème : Effi ne répond pas

• OpenWebUI est-il démarré ? docker ps | grep open-webui
• Ollama est-il accessible ? curl http://192.168.1.11:11434/api/tags
• Le PC Gaming est-il allumé ?
• Le wol-proxy fonctionne-t-il ? docker logs wol-proxy

Problème : La mémoire ne fonctionne pas

• Auto Memory est-il activé globalement ?
• Memory Injection est-il activé globalement ?
• Le modèle qwen2.5:3b est-il disponible ?
• Y a-t-il des erreurs dans les logs ? docker logs open-webui | grep -i memory

Problème : L'audio ne fonctionne pas

• speaches est-il démarré ? docker ps | grep speaches
• openedai-speech est-il démarré ?
• Les URLs dans OpenWebUI sont-elles correctes ?
• Test manuel : curl http://192.168.1.11:8200/v1/models

Problème : ROCm/GPU

• ROCm est-il installé ? rocm-smi --showproductname
• La carte est-elle détectée ? rocminfo | grep gfx
• Les conteneurs utilisent-ils les bons devices ?
• L'architecture gfx est-elle correcte ?

---

Ressources externes

• Documentation OpenWebUI
• Documentation Ollama
• Documentation ROCm AMD
• Documentation Qdrant