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

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

## ✅ `admin/ia/litellm.md` — 8/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 scripts d'administration, mais présente des lacunes dans la gestion des configurations IaC.  

**Problèmes :**
- Le template Ansible manque les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) nécessaires pour ask-agent
- Aucune mention de versionning du fichier de configuration /etc/litellm/config.yaml
- La table de coûts Claude présente des caractères non valides ($)
- Le script hermes-switch manque de détails sur les paramètres et les erreurs possibles

**Suggestions :**
- Mettre à jour le template Ansible pour inclure tous les modèles listés dans le document
- Ajouter un système de versionning pour le fichier de configuration
- Corriger le formatage de la table de coûts Claude
- Documenter en détail les paramètres et cas d'erreur du script hermes-switch

**État réel connu de Hermes :**  
Le service LiteLLM fonctionne correctement sur storage-01 avec les modèles GPU et CPU configurés manuellement. Les modèles CPU ne sont pas déployés par le template Ansible actuel, créant un point de fragilité.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète sur la configuration et les performances de llama-server sur gpu-01, avec des tests pratiques et des métriques détaillées.  

**Problèmes :**
- Manque l'information cruciale sur l'variable d'environnement HSA_OVERRIDE_GFX_VERSION=10.3.0 requise pour ROCm
- La section embeddings pourrait expliquer pourquoi le flag --pooling mean est obligatoire (compatibilité OpenAI)
- Le tableau de performances manque des métriques comme la latence ou le temps de chargement du modèle

**Suggestions :**
- Ajouter la configuration requise pour ROCm (HSA_OVERRIDE_GFX_VERSION)
- Expliciter la nécessité du pooling mean pour les LLM causaux
- Mettre à jour le tableau de performances avec des métriques complètes (prefill/génération, latence, etc.)
- Ajouter une note sur la limitation du parallélisme (1 slot requis pour Hermes)

**État réel connu de Hermes :**  
Le composant est opérationnel avec des performances conformes aux spécifications. Les métriques Prometheus sont disponibles grâce au flag --metrics, mais certaines configurations critiques (ROCm) nécessitent des paramètres supplémentaires pour fonctionner correctement.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète du système RAG dans Funk, expliquant l'architecture, les composants et les limitations du modèle d'embedding actuel.  

**Problèmes :**
- Le modèle Qwen3-8B n'est pas optimisé pour les embeddings, conduisant à des scores de similarité uniformément élevés et une perte de pertinence dans les résultats
- Le processus d'ingestion prend 5-10 minutes pour 339 chunks, pouvant être optimisé

**Suggestions :**
- Ajouter des instructions détaillées pour déployer des modèles d'embedding dédiés comme bge-m3
- Proposer un script optimisé pour l'ingestion des données
- Mettre en évidence les limitations du modèle dans la documentation pour éviter les mauvaises expectations

**État réel connu de Hermes :**  
Le système RAG est opérationnel mais avec des limitations connues dans la qualité des embeddings. La re-génération de l'index prend 5-10 minutes et nécessite synchronisation manuelle ou via Ansible.

---

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

**Statut** : à_jour  
**Résumé** : Ce document décrit les étapes de vérification et de configuration de ROCm sur une RX 6700XT (gfx1031) avec des commandes pertinentes, bien que certaines étapes manquent de contexte concret.  

**Problèmes :**
- Aucun résultat réel des commandes n'est fourni (ex: sortie de 'rocminfo')
- Les commandes ne vérifient pas la version spécifique de ROCm installée
- Manque de mention des dépendances requis (ex: package 'rocm-device-libs')

**Suggestions :**
- Ajouter des exemples de sorties attendues pour chaque commande
- Inclure une vérification de la version ROCm installée via 'rocminfo | grep ROCm'
- Mettre en évidence les packages ROCm essentiels à installer
- Ajouter une note de sécurité sur les risques de forcer HSA_OVERRIDE_GFX_VERSION

**État réel connu de Hermes :**  
null

---

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

**Statut** : à_jour  
**Résumé** : Document d'historique des incidents complet avec résolutions détaillées, mais nécessite quelques améliorations pour être parfait.  

**Problèmes :**
- La date en-tête (2026-05-29) semble antérieure à la date du document (2026-06-05)
- La section 'État post-migration' est incomplète (phrase coupée)
- Manque de contexte sur les autres incidents (seul l'incident du 29 mai est détaillé)
- Les codes d'erreur SMART (Raw_Read_Error_Rate) devraient être interprétés dans le résumé

**Suggestions :**
- Compléter la section 'État post-migration' avec les métriques actuelles du système
- Ajouter une note explicative sur le code d'erreur SMART (124014439)
- Standardiser le format des dates (AAAA-MM-JJ ou JJ/MM/AAAA)
- Ajouter un résumé synthétique des autres incidents dans l'index

**État réel connu de Hermes :**  
Le composant /srv/data utilise désormais un bind-mount NVMe XFS sans RAID5. Les services sont opérationnels, mais une surveillance continue est requise pour le disque sdb.

---