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

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

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

**Statut** : à_jour  
**Résumé** : Documentation complète sur la configuration et l'utilisation de LiteLLM avec des modèles locaux et cloud, mais présente un gap IaC critique  

**Problèmes :**
- Le template Ansible ne contient pas les modèles CPU (qwen3-1.7b-system et qwen3-1.7b-monitor) nécessaires à ask-agent
- La mention du script hermes-switch ne précise pas les risques de redémarrage du service
- Les coûts Claude sont présentés sous format incohérent (mix de dollars et de symboles)

**Suggestions :**
- Ajouter les modèles CPU au template Ansible avec des commentaires explicites
- Documenter les étapes de redémarrage du service lors des modifications de config
- Standardiser la présentation des coûts avec des unités claires (ex: $0.005/token)
- Ajouter une note de sécurité sur les permissions du fichier de configuration

**État réel connu de Hermes :**  
Le système fonctionne correctement avec les modèles ajoutés manuellement, mais le déploiement automatique via Ansible manque des composants critiques pour les agents système/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 :**
- Manque la mention de l'importance de la variable d'environnement HSA_OVERRIDE_GFX_VERSION pour RX 6700XT
- La section sur les métriques Prometheus ne précise pas comment activer le flag --metrics dans le service systemd
- Aucune mention des limites de VRAM pour les modèles CPU (malgré la présence de la section VRAM)

**Suggestions :**
- Ajouter une note sur la configuration requise pour ROCm 7.x et les dépendances système
- Mettre en évidence les commandes de vérification des métriques Prometheus avec des exemples concrets
- Ajouter une section sur la gestion des erreurs courantes (ex: débordement de VRAM, erreurs d'API)

**État réel connu de Hermes :**  
Le setup est actif sur gpu-01 avec les trois instances systemd. Les métriques Prometheus sont disponibles après activation du flag --metrics. Les performances observées correspondent aux spécifications du document.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète sur le système RAG de Funk, expliquant l'architecture, les outils déployés et les procédures d'utilisation.  

**Problèmes :**
- La limitation du modèle Qwen3-8B est clairement mentionnée mais pas priorisée dans les recommandations
- Les exemples de commandes manquent de contexte sur les cas d'usage spécifiques

**Suggestions :**
- Ajouter une note de mise en garde sur les résultats uniformément hauts en score cosinus
- Proposer un exemple concret de recherche mal ciblée vs bien ciblée avec les mêmes termes
- Mettre en évidence le délai d'ingestion (5-10 min) dans la section d'utilisation

**État réel connu de Hermes :**  
Le système RAG est opérationnel avec les outils déployés (qdrant, rag-ingest, rag-query) et intégré à Hermes via le skill rag-docs. La limitation du modèle d'embedding est confirmée par les tests pratiques.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète des étapes de vérification et de configuration ROCm pour RX 6700XT, avec des commandes clés et des notes techniques pertinentes.  

**Problèmes :**
- Redondance dans la vérification des variables d'environnement (fichiers /etc/environment et /etc/profile.d/rocm.sh)
- Absence de mention des versions ROCm actuellement installées sur les machines
- Aucune indication sur la gestion des erreurs courantes (ex: crash avec Gemma 4)

**Suggestions :**
- Ajouter une section sur la vérification des versions ROCm installées via 'rocminfo | grep 'ROCk''
- Consolider les vérifications des variables d'environnement en une seule commande
- Inclure une note de sécurité sur l'obligation de HSA_OVERRIDE_GFX_VERSION=10.3.0 pour gfx1031

---

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

**Statut** : ok  
**Résumé** : Document d'historique des incidents complet avec résolutions détaillées, bien structuré et technique  

**Problèmes :**
- Format markdown des tableaux non parfait (alignement des colonnes)
- Certains résumés contiennent des sauts de ligne non convertis en breaks
- La syntaxe des blocs de code (dmesg, rsync) pourrait être standardisée

**Suggestions :**
- Ajouter des breaks ligne (\n) pour les résumés multi-lignes
- Standardiser les blocs de code avec backticks
- Ajouter une section de conclusion sur l'impact global des incidents

**État réel connu de Hermes :**  
Migration réussie de /srv/data vers NVMe, systèmes RAID5 dégradés remplacés, corruptions résolues

---

