docs(hermes): rapport analyse 2026-06-09_18-00 — 5 fichiers

Analysés : litellm.md, llama_server.md, rag.md, rocm.md, incidents.md
À améliorer : 0/5

Co-Authored-By: Hermes <hermes@funk.lab>
This commit is contained in:
Hermes Bot 2026-06-09 18:02:52 +02:00
parent 9c8c10c0e3
commit af5ff72b49

View file

@ -0,0 +1,109 @@
# Rapport Hermes — 2026-06-09_18-00
> 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 de LiteLLM avec des modèles CPU/GPU, mais présente un gap IaC dans le template Ansible
**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 que le template Ansible ne les inclut pas
- La section 'Coût Claude' manque de détails précis (tarifs par token, exemples concrets)
- Aucune mention des métriques de performance (tok/s) pour les modèles GPU
**Suggestions :**
- Mettre à jour le template Ansible (config.yaml.j2) pour inclure les modèles CPU
- Ajouter des exemples de coûts par token pour les modèles Claude
- Indiquer les débits de tok/s pour chaque modèle (ex: 60 tok/s pour Qwen3-8B GPU)
**État réel connu de Hermes :**
Les modèles CPU sont fonctionnels via des modifications manuelles, mais le déploiement standard via Ansible ne garantit pas leur présence
---
## ✅ `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 du paramètre HSA_OVERRIDE_GFX_VERSION=10.3.0 crucial pour ROCm sur RX 6700XT
- La section métriques Prometheus pourrait préciser les unités et les seuils d'alerte
**Suggestions :**
- Ajouter la configuration requise pour ROCm (HSA_OVERRIDE_GFX_VERSION)
- Expliciter les unités des métriques (tok/s, GB VRAM)
- Ajouter des exemples de requêtes API pour les embeddings
- Inclure des étapes de débogage pour les erreurs de VRAM
**État réel connu de Hermes :**
Le composant est opérationnel avec 9GB VRAM utilisés (sous le seuil de 12GB). Les métriques Prometheus sont activables via --metrics, mais le débit de génération (60 tok/s) pourrait être optimisé avec un parallélisme accru.
---
## ✅ `admin/ia/rag.md` — 9/10
**Statut** : à_jour
**Résumé** : Document détaillé sur la configuration RAG du homelab Funk, incluant architecture, composants, modèles d'embedding et procédures de mise à jour.
**Problèmes :**
- La limitation du modèle Qwen3-8B comme modèle d'embedding dédié n'est pas suffisamment mise en avant
- Les scores de similarité cosinus uniformément élevés (0.90-0.95) pourraient être illustrés par des exemples concrets
**Suggestions :**
- Ajouter une note explicative sur les implications pratiques des scores de similarité élevés (ex: fichier incidents.md qui domine les résultats)
- Mettre en évidence les étapes critiques pour la re-ingestion d'index (temps, ressources GPU)
- Proposer un benchmark rapide entre les modèles d'embedding alternatifs (nomic-embed-text-v1.5 vs bge-m3)
**État réel connu de Hermes :**
Le système RAG est opérationnel avec l'index actuel. Les limitations du modèle d'embedding affectent la précision sémantique, mais les procédures d'indexation automatisées via Ansible garantissent une mise à jour régulière des données.
---
## ✅ `admin/ia/rocm.md` — 9/10
**Statut** : à_jour
**Résumé** : Le document ROCm.md est complet et à jour avec les configurations requises pour le RX 6700XT sur gpu-01, incluant les vérifications, variables d'environnement et débogage.
**Problèmes :**
- La commande 'rocm-smi' n'est pas disponible sur gpu-01, ce qui pourrait être un point d'amélioration pour clarifier cette limitation
**Suggestions :**
- Ajouter une note explicite sur la limitation de 'rocm-smi' et ses implications
- Mettre à jour les commandes de vérification pour inclure des tests de performance GPU
- Ajouter une section sur la gestion des erreurs courantes lors de la configuration ROCm
**État réel connu de Hermes :**
Aucune divergence détectée avec la documentation. Services ROCm conformes, configuration actuelle stable sans crash de pod.
---
## ✅ `admin/incidents.md` — 7/10
**Statut** : à_jour
**Résumé** : Document complet avec historique des incidents, mais présentant des incohérences de formatage et un manque de synthèse globale
**Problèmes :**
- Tableau d'index avec en-têtes en gras mais lignes non formatées de manière cohérente
- Manque de conclusion synthétique pour chaque incident
- Densité technique excessive des résolutions sans hiérarchisation
- Absence de classification des incidents par type (hardware, logiciels, configuration)
- Format markdown incohérent entre les sections (pipes vs. deux-points)
**Suggestions :**
- Standardiser le formatage des tableaux avec en-têtes alignés
- Ajouter une section 'Catégories' pour classifier les incidents
- Diviser les résolutions techniques en étapes numérotées avec explications brèves
- Inclure un résumé visuel des états post-résolution
- Ajouter des balises YAML pour les métadonnées (date, auteur, gravité)
**État réel connu de Hermes :**
Le RAID5 a été migré vers NVMe avec succès, les composants critiques sont maintenant opérationnels. Le système de stockage utilise désormais un bind-mount XFS sur NVMe.
---