# 🔧 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/)