Analysés : litellm.md, llama_server.md, rag.md, rocm.md, incidents.md À améliorer : 0/5 Co-Authored-By: Hermes <hermes@funk.lab>
4.9 KiB
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