# Rapport Hermes — 2026-06-05_17-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 incohérences dans la gestion des modèles CPU via Ansible  

**Problèmes :**
- Le template Ansible litellm/config.yaml.j2 manque les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) référencés dans la configuration réelle
- La section 'Coût Claude' contient des valeurs mal formatées (~-bash.24)
- Le script hermes-switch n'est pas documenté en détail (méthodes de fonctionnement, sécurité)

**Suggestions :**
- Mettre à jour le template Ansible pour inclure les modèles CPU manquants
- Corriger le format des coûts Claude (ex: $0.024 par million de tokens)
- Ajouter une explication technique sur le fonctionnement du script hermes-switch et ses implications de sécurité

**État réel connu de Hermes :**  
Les modèles CPU sont configurés manuellement sur storage-01, ce qui crée un point de fracture avec l'infrastructure Ansible. Le déploiement sur un hôte vierge manquerait ces configurations essentielles pour ask-agent system/monitor.

---

## ✅ `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 détaillées.  

**Problèmes :**
- Mention du 'bug parallel' sans explication concrète
- Absence de précision sur la version exacte de ROCm 7.x
- Aucune mention des considérations de sécurité (SELinux, accès réseau)

**Suggestions :**
- Ajouter une note explicite sur la résolution du bug de parallélisme
- Spécifier la version exacte de ROCm requise (ex: 7.1.0)
- Inclure une section sur les règles de sécurité (firewalld/nftables, contrôle d'accès)
- Mettre en évidence le risque de surcharge VRAM avec des scénarios d'usage intensif

**État réel connu de Hermes :**  
Le setup est opérationnel avec 9GB de VRAM utilisée. Le bug de parallélisme affecte les performances Hermes, nécessitant un patch spécifique. Les métriques Prometheus sont actives avec les endpoints /metrics configurés.

---

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

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

**Problèmes :**
- Le modèle d'embedding Qwen3-8B n'est pas optimisé pour la recherche sémantique (scores cosinus uniformément élevés)
- Temps d'ingestion long (5-10 minutes pour 339 chunks)

**Suggestions :**
- Tester les modèles d'embedding spécialisés comme bge-m3 pour améliorer la pertinence des résultats
- Ajouter des exemples de requêtes complexes dans la section 'Utilisation'
- Mettre en avant les alternatives de modèles d'embedding dans la documentation du déploiement

**État réel connu de Hermes :**  
Le système RAG est actif sur storage-01 avec Qdrant et les outils rag-query/rag-ingest. L'index contient 339 chunks dimensionnés 4096 (cosinus).

---

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

**Statut** : à_jour  
**Résumé** : Document complet sur la configuration ROCm pour RX 6700XT, couvrant vérifications de base, variables d'environnement, modules kernel et debug, mais manque d'explications contextuelles pour certaines variables  

**Problèmes :**
- Aucune explication sur le pourquoi de HSA_OVERRIDE_GFX_VERSION=10.3.0
- Commandes redondantes (lspci, lsmod) pouvant être consolidées
- Absence de workaround pour rocm-smi non disponible sur gpu-01

**Suggestions :**
- Ajouter une explication technique sur le besoin de HSA_OVERRIDE_GFX_VERSION
- Proposer des alternatives si rocm-smi n'est pas disponible
- Structurer les sections par catégories (diagnostic, configuration, debug)

**État réel connu de Hermes :**  
ROCm fonctionnel avec kernel 5.14.0, noyau AMD détecté, modules amdgpu chargés, aucune divergence détectée avec la configuration documentée, rocm-smi non disponible mais pas critique pour le fonctionnement

---

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

**Statut** : à_jour  
**Résumé** : Document d'historique des incidents complet avec résolutions détaillées, mais présente des incohérences de format et des améliorations possibles.  

**Problèmes :**
- Incohérence dans les niveaux de sévérité (mélange de 'Important', 'Critique', 'Warning')
- Tableau d'index mal aligné (entêtes de colonnes incomplets)
- Phrase incomplète dans l'état post-migration ('Espace disponibl')
- Absence de gestion des contextes SELinux dans les étapes de rsync
- Commandes sudo sans spécification du utilisateur (risque de confusion)

**Suggestions :**
- Normaliser les niveaux de sévérité (ex: 'Critique', 'Majeur', 'Mineur')
- Ajouter une section 'Leçons apprises' pour chaque incident
- Corriger la phrase incomplète dans l'état post-migration
- Ajouter des notes explicatives sur les codes d'erreur SELinux
- Mettre à jour les tableaux pour aligner correctement les colonnes

**État réel connu de Hermes :**  
{'RAID5': 'Désactivé, données migrées vers NVMe', 'sdb': 'Marqué comme défaillant, hors du RAID', 'qdrant': 'Corrections appliquées, fonctionnel', 'services': 'Tous les services restaurés après migration'}

---

