# Rapport Hermes — 2026-06-06_09-30
> Branche : `hermes/daily-work` · Fichiers analysés : 5

---
## Résumé
- ✅ À jour : 5
- ⚠️  À améliorer : 0

## ✅ `admin/ia/litellm.md` — 7/10

**Statut** : à_jour  
**Résumé** : Documentation complète sur la configuration et l'utilisation de LiteLLM avec des informations sur les modèles, coûts et intégration Ansible, mais présentant des lacunes dans la gestion des modèles CPU.  

**Problèmes :**
- Les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) sont manuellement ajoutés dans /etc/litellm/config.yaml alors qu'ils manquent du template Ansible
- La table des coûts Claude contient des caractères non valides ($ dans les colonnes de coût)
- La ligne 'Utilisation courante' manque de chiffres concrets
- Le script hermes-switch n'est pas documenté en détail dans le fichier

**Suggestions :**
- Mettre à jour le template Ansible (config.yaml.j2) pour inclure les modèles CPU
- Corriger le formatage de la table des coûts Claude
- Ajouter des exemples concrets de coûts pour 'Utilisation courante'
- Documenter les paramètres et les étapes du script hermes-switch

**État réel connu de Hermes :**  
Les modèles CPU sont présents dans la configuration actuelle mais manquent du déploiement automatique via Ansible, créant un point de fragilité dans le CI/CD

---

## ✅ `admin/ia/llama_server.md` — 8/10

**Statut** : à_jour  
**Résumé** : Documentation complète sur la configuration et les performances du llama-server sur gpu-01, avec des instructions opérationnelles et des métriques de surveillance.  

**Problèmes :**
- Manque la mention de l'environment variable HSA_OVERRIDE_GFX_VERSION=10.3.0 requise pour ROCm
- Le paragraphe sur les performances mentionne un 'bug parallel' sans expliquer la cause ni la solution
- Les métriques Prometheus ne mentionnent pas les endpoints spécifiques aux instances CPU (1236/1237)

**Suggestions :**
- Ajouter la configuration requise pour ROCm (HSA_OVERRIDE_GFX_VERSION)
- Documenter la solution au bug de parallélisme Hermes
- Spécifier les endpoints metrics pour chaque instance systemd
- Ajouter une note sur la limitation VRAM et les priorités de charge

**État réel connu de Hermes :**  
Le setup est opérationnel avec des performances conformes, mais nécessite des ajustements pour optimiser la compatibilité ROCm et la surveillance complète des instances CPU.

---

## ✅ `admin/ia/rag.md` — 8/10

**Statut** : à_jour  
**Résumé** : Documentation complète sur l'implémentation RAG du homelab, avec architecture, composants, modèles et procédures de mise à jour.  

**Problèmes :**
- Utilisation d'un modèle génératif (Qwen3-8B) pour les embeddings, ce qui limite la discrimination sémantique
- Scores de similarité uniformément élevés (0.90-0.95) indiquant une perte de pertinence dans les résultats

**Suggestions :**
- Déployer un modèle d'embedding dédié comme bge-m3 pour améliorer la précision sémantique
- Mettre à jour la documentation avec les étapes de migration vers un modèle optimisé
- Ajouter des tests de validation des résultats de recherche

**État réel connu de Hermes :**  
Le système RAG est actif sur storage-01 avec Qdrant et rag-query. L'index contient 339 chunks, mais les résultats de recherche souffrent de la limitation du modèle actuel.

---

## ✅ `admin/ia/rocm.md` — 9/10

**Statut** : à_jour  
**Résumé** : Document détaillé sur la configuration ROCm pour RX 6700XT avec vérifications complètes et état actualisé au 05/06/2026  

**Problèmes :**
- Manque une section sur la gestion des mises à jour ROCm
- Aucune mention des limites connues avec Gemma 4
- Le check 'rocm-smi' non disponible n'est pas expliqué

**Suggestions :**
- Ajouter une section sur la surveillance thermique proactive
- Inclure des exemples de scripts pour automatiser les vérifications
- Mettre en évidence les prérequis spécifiques à AlmaLinux 9.7
- Ajouter une note de sécurité sur les accès GPU via sudo

**État réel connu de Hermes :**  
ROCm configuré correctement avec HSA_OVERRIDE_GFX_VERSION=10.3.0, noyau 5.14.0, aucun incident signalé, services NFS exportés normalement

---

## ✅ `admin/incidents.md` — 8/10

**Statut** : à_jour  
**Résumé** : Document d'historique des incidents technique avec résolutions détaillées et état post-migration  

**Problèmes :**
- Formatage markdown incohérent entre tables et sections
- Manque de hiérarchisation visuelle pour les résolutions techniques
- Tableau 'État post-migration' incomplet (colonnes tronquées)

**Suggestions :**
- Ajouter des balises de niveau 3 (#) pour les sections de résolution
- Utiliser des listes à puces pour les étapes de résolution
- Compléter le tableau d'état post-migration avec les colonnes 'Avant/Après'
- Ajouter un résumé visuel des actions clés en fin de document

**État réel connu de Hermes :**  
Migration RAID5 → NVMe réussie, système stable, composants déployés sur stockage NVMe (XFS), RAID5 décommissionné

---

