docs(hermes): rapport analyse 2026-06-05_20-30 — 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-05 20:32:58 +02:00
parent e61b7e2d67
commit 0e650ebba5

View file

@ -0,0 +1,107 @@
# Rapport Hermes — 2026-06-05_20-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 de gestion, mais présente un gap IaC dans les templates 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 manuellement dans /etc/litellm/config.yaml
- Les coûts Claude sont présentés sous forme de tableau incohérent avec des valeurs mixtes (ex: '-bash.24')
- Le script hermes-switch n'est pas décrit dans le fichier, seulement dans un lien externe
**Suggestions :**
- Mettre à jour le template Ansible pour inclure tous les modèles référencés (y compris les CPU)
- Normaliser la présentation des coûts avec des valeurs numériques cohérentes
- Ajouter une explication détaillée du script hermes-switch dans le fichier
**État réel connu de Hermes :**
Les modèles CPU existent manuellement dans la configuration, mais leur absence dans le template Ansible crée un risque de défaillance lors de l'application de la configuration via IaC
---
## ✅ `admin/ia/llama_server.md` — 9/10
**Statut** : à_jour
**Résumé** : Documentation complète sur la configuration et l'utilisation de llama-server sur gpu-01, avec détails sur les instances systemd, modèles, performances et métriques.
**Problèmes :**
- Erreur de frappe dans la section Prometheus : 'backpressu' incomplet
- Manque de précision sur le 'bug parallel' mentionné dans la section Performances
**Suggestions :**
- Corriger le typo dans la section Prometheus
- Ajouter des exemples de tests de charge ou de benchmarks plus complets
- Préciser les conditions exactes du bug 'parallel' et sa résolution
**État réel connu de Hermes :**
Le composant est correctement configuré avec des métriques opérationnelles. Les instances systemd fonctionnent selon les specs, mais le bug de parallélisme nécessite une vérification supplémentaire.
---
## ✅ `admin/ia/rag.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète sur l'implémentation RAG de Funk, incluant architecture, composants, modèles d'embedding et processus de mise à jour.
**Problèmes :**
- Utilisation de Qwen3-8B (modèle génératif) pour les embeddings au lieu d'un modèle dédié
- Temps de re-indexation long (5-10 minutes pour 339 chunks)
**Suggestions :**
- Evaluer le déploiement de nomic-embed-text-v1.5 ou bge-m3 pour des embeddings plus précis
- Optimiser l'ingestion avec des modèles CPU pour réduire le temps d'exécution
- Ajouter des exemples concrets de requêtes RAG dans la section d'utilisation
**É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 dimensionnés 4096 (cosine). La documentation est synchronisée via Ansible et rsync.
---
## ✅ `admin/ia/rocm.md` — 8/10
**Statut** : à_jour
**Résumé** : Le document ROCm.md est complet et à jour, couvrant les vérifications de base, les configurations clés et les diagnostics, avec un état opérationnel stable du composant.
**Problèmes :**
- Le document ne mentionne pas de alternatives pour le cas où 'rocm-smi' est indisponible (ex: outils de monitoring alternatifs)
- La section 'État vérifié' pourrait préciser si les outils comme 'rocm-smi' sont attendus ou non
**Suggestions :**
- Ajouter une note sur les alternatives de monitoring GPU sans 'rocm-smi' (ex: 'nvidia-smi' pour comparaison, ou outils de surveillance système)
- Mettre en évidence les versions ROCm testées et les patchs kernel associés (5.14.0-687.5.3.el9_8.x86_64)
- Préciser si le 'HSA_OVERRIDE_GFX_VERSION=10.3.0' est persistant dans les sessions interactives (profil d'utilisateur)
**État réel connu de Hermes :**
ROCm fonctionne correctement sur gpu-01 avec RX 6700XT (gfx1031) après override de la version GFX. Aucun crash détecté, configuration conforme, NFS export fonctionnel, et modules kernel amdgpu chargés. 'rocm-smi' non disponible mais cela ne bloque pas le fonctionnement principal.
---
## ✅ `admin/incidents.md` — 8/10
**Statut** : à_jour
**Résumé** : Document d'historique des incidents technique du homelab Funk avec résolutions détaillées, bien organisé mais avec quelques lacunes de clôture
**Problèmes :**
- Section 'État post-migration' incomplète (coupure de texte)
- Manque de statut 'État réel' pour plusieurs incidents
- Absence de date de mise à jour du document
- Certains symptômes déclencheurs manquent de contexte système
**Suggestions :**
- Compléter la section d'état post-migration avec les mesures de validation
- Ajouter un champ 'État réel' pour chaque incident avec la configuration actuelle
- Inclure une date de dernière mise à jour en haut du document
- Standardiser le format des symptômes déclencheurs avec des exemples de dmesg/ journalctl
**État réel connu de Hermes :**
null
---