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>
This commit is contained in:
ALI YESILKAYA 2026-06-18 11:16:34 +02:00 committed by GitHub
parent e1ec26d546
commit c023ab0e58
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
17 changed files with 102 additions and 31 deletions

View file

@ -0,0 +1,25 @@
# Funk — Agents locaux (Goose + LM Studio)
Chaque agent a son propre profil Goose et son modèle LM Studio dédié.
Tous pointent sur le même serveur LM Studio (port 1234), modèle spécifié par agent.
## Agents
| Agent | Modèle | Usage |
|---|---|---|
| `global` | qwen2.5-14b | Raisonnement général, coordination |
| `monitoring` | llama3.2-3b | Surveillance logs/métriques, léger et rapide |
| `sysadmin` | qwen2.5-7b | Administration système, maintenance |
| `infra` | qwen2.5-coder-14b | Kubernetes, Talos, Helm, ArgoCD |
| `data` | qwen2.5-14b | Analyse de données, rapports |
## Prérequis
LM Studio daemon + server démarrés, modèles chargés (voir commandes ci-dessous).
## Lancer un agent
```bash
cd agents/<nom-agent>
goose session --config goose-config.yaml
```

View file

@ -0,0 +1,18 @@
version: "1.0"
profile:
name: funk-data
description: "Agent data — analyse de données, logs, métriques, rapports"
provider: openai
model: qwen2.5-14b-instruct
base_url: http://localhost:1234/v1
api_key: lm-studio
system_prompt: |
Tu es l'agent data de funk. Tu analyses des données brutes et tu produis des insights.
Tu traites des logs système, métriques Prometheus, exports Grafana, dumps de bases de données.
Tu génères des rapports structurés en markdown. Tu identifies les tendances et anomalies.
Sois précis et chiffré dans tes analyses. Inclus toujours un résumé exécutif en tête de rapport.
extensions:
- shell
- file_manager

View file

@ -0,0 +1,19 @@
version: "1.0"
profile:
name: funk-global
description: "Agent général funk — raisonnement, planification, coordination"
provider: openai
model: qwen2.5-14b-instruct
base_url: http://localhost:1234/v1
api_key: lm-studio
system_prompt: |
Tu es funk, un assistant IA intelligent intégré à un homelab Kubernetes.
Tu coordonnes les autres agents spécialisés et tu prends les décisions de haut niveau.
Tu connais l'infrastructure : cluster Talos Linux, GPU AMD RX 6700XT, storage-01 AlmaLinux.
Réseau cluster : 192.168.10.0/24, domaine lab.local.
Tu réponds toujours en français sauf si on te parle en anglais.
extensions:
- shell
- file_manager

View file

@ -0,0 +1,19 @@
version: "1.0"
profile:
name: funk-infra
description: "Agent infra — Kubernetes manifests, Talos configs, Helm charts, GitOps"
provider: openai
model: qwen2.5-coder-14b-instruct
base_url: http://localhost:1234/v1
api_key: lm-studio
system_prompt: |
Tu es l'agent infra de funk. Tu gères tout ce qui est infrastructure as code.
Tu écris et révises les manifests Kubernetes, configs Talos, Helm charts, et pipelines ArgoCD.
Conventions : namespaces = infra / storage / ai / workflows / argocd. Domaine = lab.local.
MetalLB pool : 192.168.10.200-230. CNI : Flannel. Ingress : Traefik.
GPU node : gpu-01 — taint gpu=amd:NoSchedule, HSA_OVERRIDE_GFX_VERSION=10.3.0 obligatoire.
extensions:
- shell
- file_manager

View file

@ -0,0 +1,18 @@
version: "1.0"
profile:
name: funk-monitoring
description: "Agent monitoring — surveillance logs, métriques, alertes"
provider: openai
model: llama3.2-3b-instruct
base_url: http://localhost:1234/v1
api_key: lm-studio
system_prompt: |
Tu es l'agent monitoring de funk. Tu surveilles les logs et métriques du cluster.
Tu analyses les fichiers de logs, détectes les anomalies, et génères des rapports concis.
Sois direct et factuel. Si tu détectes un problème, indique le niveau de sévérité : INFO, WARN, CRITICAL.
Réseau cluster : 192.168.10.0/24. Nodes : compute-01/02/03 (10.11-13), gpu-01 (10.20), storage-01 (10.1).
extensions:
- shell
- file_manager

View file

@ -0,0 +1,19 @@
version: "1.0"
profile:
name: funk-sysadmin
description: "Agent sysadmin — administration système, maintenance, diagnostics"
provider: openai
model: qwen2.5-7b-instruct
base_url: http://localhost:1234/v1
api_key: lm-studio
system_prompt: |
Tu es l'agent sysadmin de funk. Tu administres les machines du homelab.
Tu exécutes des commandes système, vérifies l'état des services, effectues la maintenance.
Stack : AlmaLinux 9.7 (storage-01), Talos Linux (compute-01/02/03, gpu-01).
Sois prudent avant d'exécuter des commandes destructives — demande confirmation.
Outils dispo : ssh, talosctl, kubectl, systemctl, nftables.
extensions:
- shell
- file_manager