akadmin/Funk-lab

mirror of https://github.com/Alkatrazz24/Funk-lab.git synced 2026-07-08 08:24:42 +02:00

History

ALI YESILKAYA 1faf50a9be feat(stt-server): contextes présélectionnables + sources live + contexte assemblé (visualiseur) (#38 ) Asa n'est plus bloqué sur le seul contexte « doc cluster grounding-strict ». Le client choisit un contexte par requête ; le serveur change le system prompt ET injecte les données live du domaine, puis renvoie le contexte assemblé pour le visualiseur du HUD. - contexts.py : profils funk / ghostfolio / grafana / alerting / cluster (system prompt + sources) + assemble() (prompt final + structure de visualisation). - sources.py : fetchers live best-effort (Ghostfolio auth+details, Alertmanager alerts hors Watchdog, Prometheus cluster/metrics), env-config, dégradation propre. - brain.py : ask() reçoit le system prompt déjà assemblé (assemblage remonté). - app.py : /v1/ask accepte `context`, renvoie context_id + le contexte assemblé ; nouveau GET /v1/contexts ; RAG doc conditionné au profil. - config.py : URLs sources + STT_GHOSTFOLIO_TOKEN + STT_DEFAULT_CONTEXT. - deployment : env in-cluster (Prometheus/Alertmanager monitoring, Ghostfolio ai), jeton via secret optionnel stt-server-secrets/ghostfolio-token. - bump 0.3.1 → 0.4.0. Validé en local : assemblage (blocs+RAG+mémoire), parsing des sources (mock), endpoints /v1/contexts et /v1/ask (LLM mocké) — context_id, visualiseur, fallback contexte inconnu → funk. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>		2026-06-20 23:49:29 +02:00
..
hermes/builtin	docs(hermes): rapport analyse 2026-06-05_11-30 — 5 fichiers	2026-06-05 11:32:58 +02:00
ia	feat(stt-server): contextes présélectionnables + sources live + contexte assemblé (visualiseur) (#38 )	2026-06-20 23:49:29 +02:00
infra	feat(stt-server): grounding strict — dire "doc ne le précise pas" au lieu d'inventer (#29 )	2026-06-20 12:17:29 +02:00
install	docs: kubernetes — section NFS provisioner complète (install, usage, admin, pièges)	2026-05-13 22:10:26 +02:00
k8s	docs(rag): chunk dense « nœuds + OS » pour fermer le trou de grounding (cas Q3) (#33 )	2026-06-20 21:41:13 +02:00
ops	chore(gpu-01): retire les serveurs llama CPU system/monitor/dev (inutilisés) (#31 )	2026-06-20 13:25:50 +02:00
funk-cluster	docs(admin): add ops documentation and fix hermes dashboard service	2026-05-12 18:50:43 +02:00
incidents-llm-gpu.md	fix(llama_server): embed nomic sur CPU — supprime la contention GPU (docs=0) (#30 )	2026-06-20 12:38:08 +02:00
incidents.md	feat(stt): entrée texte HUD + finitions client + doc incident LLM/GPU (#19 )	2026-06-19 14:56:36 +02:00
index_knowledge.py	chore(gpu-01): retire les serveurs llama CPU system/monitor/dev (inutilisés) (#31 )	2026-06-20 13:25:50 +02:00
README.md	docs: passe de cohérence documentaire (STT, Ghostfolio, embeddings, Qdrant) (#15 )	2026-06-18 11:16:34 +02:00

README.md

Administration Funk — Index

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.