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
commit d1e12cff60
35 changed files with 4656 additions and 0 deletions
@@ -0,0 +1,119 @@
+# 🔧 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](./rocm-amd-gpu.md)
+- `hipErrorInvalidDeviceFunction`
+- `float16 not supported on CPU backend`
+- Build CTranslate2 pour gfx1100
+- ROCm non détecté
+
+### 🌐 [Réseau et Ports](./reseau-et-ports.md)
+- 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
+
+```bash
+# 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
+
+```bash
+# 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](https://docs.openwebui.com/)
+- [Documentation Ollama](https://github.com/ollama/ollama/blob/main/docs/README.md)
+- [Documentation ROCm AMD](https://docs.amd.com)
+- [Documentation Qdrant](https://qdrant.tech/documentation/)