akadmin/Funk-lab
1
0
Fork 0
mirror of https://github.com/Alkatrazz24/Funk-lab.git synced 2026-07-08 17:44:42 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
Funk-lab/admin/README.md
ALI YESILKAYA c023ab0e58
docs: passe de cohérence documentaire (STT, Ghostfolio, embeddings, Qdrant) (#15) 
Aligne la documentation sur l'état réel du cluster au 2026-06-18 :

- Qdrant : crash-loop résolu le 17/06 (statut « HS / EN COURS » corrigé dans
  CLAUDE.md, README, admin/ia/rag.md, admin/incidents.md, admin/ia/stt.md).
  Précision : collection funk-docs supprimée lors de la réparation → re-ingest
  RAG encore à faire (pas de surévaluation du statut).
- STT (assistant vocal « Jarvis ») : ajouté partout (était déployé mais non documenté).
- Ghostfolio : ajouté partout (était déployé mais non documenté).
- Embeddings dédiés nomic-embed-text :1238 : marqués opérationnels (roadmap
  README disait encore « TODO »).
- llama-server : ×3 → ×4 (instance embeddings) ; gap IaC précisé (embeddings géré
  par le rôle, seules les 2 instances CPU restent manuelles).
- Structure k8s/ corrigée dans CLAUDE.md : ajout stt/ + ghostfolio/, suppression
  des sous-dossiers traefik/ + metallb/ inexistants (installés via helm au bootstrap).
- Namespaces et liste des secrets Vault (vault_pg_ghostfolio_password) complétés.
- admin/README.md : index complété (~10 docs manquants : email, n8n, open-webui,
  ghostfolio, k9s, stt, rag, hermes-voice/souls/auto-improve, alertmanager-webhook).
- Funk/ (conception d'origine : LM Studio + agents Goose, obsolète) déplacé sous
  archive/ avec bandeau « obsolète » + archive/README.md (historique git préservé).


Claude-Session: https://claude.ai/code/session_017Qjq5jHiqNepnobJpHYpCa

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-18 11:16:34 +02:00

4 KiB
Raw Permalink Blame History

Administration Funk — Index

Navigation rapide

Besoin Fichier
Allumer / éteindre le homelab ops/cluster.md
Déployer quelque chose sur k8s k8s/argocd.md
Débugger l'inférence LLM ia/llama_server.md · ia/rocm.md
Débugger Hermes / ask-agent ia/hermes.md
Assistant vocal (STT / « Jarvis ») ia/stt.md · ia/hermes-voice.md
RAG / recherche dans la doc ia/rag.md
Voir les métriques / alertes k8s/monitoring.md
Problème réseau / nftables infra/reseau.md
Problème NFS / stockage infra/nfs.md
Incident passé incidents.md

Guides d'installation (première mise en place)

Guide Cible
install/storage-01.md AlmaLinux + RAID5 + Ansible + stack IA complète
install/gpu-01.md AlmaLinux + ROCm + llama-server (RX 6700XT)
install/kubernetes.md Talos + MetalLB + Traefik + DNS wildcard + NFS + monitoring

ops/ — Opérations quotidiennes

Fichier Contenu
ops/cluster.md funk-start, funk-stop, funk-status — démarrage/arrêt cluster complet
ops/ansible.md Commandes Ansible — ping, apply, vault, debug, facts
ops/systeme.md Services systemd, logs, ressources, NetworkManager, dnf

infra/ — Infrastructure socle

Fichier Contenu
infra/reseau.md nftables, IP forwarding, routage, NAT, debug
infra/nfs.md NFS + RAID5 — exports, montages, automount, ajout de partages
infra/dnsmasq.md DNS local lab.local — résolution, logs, ajout d'entrées
infra/ssh.md Connexions SSH — alias, jump host, transfert de fichiers
infra/email.md Postfix relay — SMTP sortant via Gmail (App Password)

k8s/ — Cluster Kubernetes

Fichier Contenu
k8s/talos.md Talos Linux — talhelper, nœuds, upgrades, backup etcd
k8s/argocd.md ArgoCD GitOps — App of Apps, déploiement, dépannage
k8s/monitoring.md Grafana · Prometheus · AlertManager — métriques, dashboards, alertes
k8s/n8n.md n8n — automatisation, workflows actifs, credentials
k8s/open-webui.md Open WebUI — chat web, backend LiteLLM
k8s/ghostfolio.md Ghostfolio — suivi de portefeuille (PostgreSQL s01 + Redis)
k8s/k9s.md k9s — TUI de gestion du cluster

ia/ — Stack IA Funk

Fichier Contenu
ia/llama_server.md llama-server — 4 instances (GPU + 2× CPU + embeddings :1238), métriques, build, modèles
ia/rocm.md GPU RX 6700XT — ROCm, HSA_OVERRIDE_GFX_VERSION, debug
ia/litellm.md LiteLLM Proxy — routage Qwen local + Claude API, config, validation
ia/hermes.md Hermes Agent + ask-agent — profils, skills, SOUL.md, délégation
ia/hermes-souls.md Prompts système (souls) par profil Hermes
ia/hermes-auto-improve.md Worker d'analyse quotidienne de la doc par Hermes (trigger :9095)
ia/hermes-voice.md Client vocal Hermes (CLI : faster-whisper + Piper + wake word)
ia/stt.md STT — assistant vocal « Jarvis » (client stt + STT-server in-cluster + mémoire)
ia/rag.md RAG — rag-query/rag-ingest, Qdrant funk-docs, embeddings
ia/alertmanager-webhook.md Pont AlertManager → ask-agent (analyse LLM des alertes)

incidents.md

incidents.md — historique des incidents avec causes, résolutions et fixes permanents.