Files
Effi/docs/04-depannage/README.md
T
Folzo d1e12cff60 Initial commit: Documentation Effi v1.0
- Structure complète du projet
- Docker compose de production
- Documentation organisée par thèmes
- Guides d'installation et configuration
- Section dépannage détaillée
- Journal historique
2026-04-04 08:45:59 +02:00

2.9 KiB

🔧 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