mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-10 04:44:42 +02:00
docs: passe de cohérence documentaire (STT, Ghostfolio, embeddings, Qdrant)
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é). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017Qjq5jHiqNepnobJpHYpCa
This commit is contained in:
parent
e1ec26d546
commit
1f2d970398
17 changed files with 102 additions and 31 deletions
26
README.md
26
README.md
|
|
@ -69,12 +69,13 @@ L'ensemble est géré en Infrastructure-as-Code : **Ansible** pour les hôtes Al
|
|||
|
||||
| Composant | Rôle | Hôte |
|
||||
|---|---|---|
|
||||
| **llama-server** (×3) | Inférence GPU + 2× CPU isolés (ROCm 7.x) | gpu-01 |
|
||||
| **llama-server** (×4) | Inférence GPU (:1234) + 2× CPU isolés (:1236/:1237) + embeddings dédiés nomic-embed-text (:1238) — ROCm 7.x | gpu-01 |
|
||||
| **LiteLLM** | Proxy API — routing local/cloud transparent | storage-01 |
|
||||
| **Hermes Agent** | Agent IA multi-profils avec mémoire vectorielle | storage-01 |
|
||||
| **ask-agent** | Délégation inter-agents (system / monitor / brain) | storage-01 |
|
||||
| **Qdrant** | Base vectorielle pour la mémoire sémantique | storage-01 |
|
||||
| **PostgreSQL 16** | Persistance Hermes + LiteLLM | storage-01 |
|
||||
| **STT** | Assistant vocal « Jarvis » — client `stt` (poste) + STT-server in-cluster | k8s (`ai`) |
|
||||
| **Qdrant** | Base vectorielle — RAG (`funk-docs`) + mémoire STT (`stt-memory`) | storage-01 |
|
||||
| **PostgreSQL 16** | Persistance Hermes, LiteLLM, n8n, Open WebUI, Ghostfolio | storage-01 |
|
||||
|
||||
### Profils Hermes
|
||||
|
||||
|
|
@ -143,13 +144,15 @@ L'ensemble est géré en Infrastructure-as-Code : **Ansible** pour les hôtes Al
|
|||
│ └── souls/ # Prompts système par profil (funk-ai, system, monitor, brain)
|
||||
├── tools/ # Sources des outils déployés
|
||||
│ ├── hermes-auto-improve/ # auto-improve.py + trigger-server.py
|
||||
│ └── hermes-voice/ # Client vocal Hermes
|
||||
│ └── hermes-voice/ # Client vocal Hermes (CLI faster-whisper + Piper)
|
||||
├── stt/ # Assistant vocal « Jarvis » — client `stt` (pipx) + STT-server (conteneur)
|
||||
├── admin/ # Base de connaissance (indexée dans le RAG)
|
||||
├── progress/ # Journaux de session (référencés par PROGRESS.md)
|
||||
├── archive/ # Documents historiques obsolètes (conception d'origine) — ne fait pas foi
|
||||
├── talos/ # Cluster Kubernetes (talhelper)
|
||||
└── k8s/ # Workloads ArgoCD
|
||||
├── infra/ # MetalLB, Traefik, monitoring, nfs-provisioner
|
||||
└── apps/ # Open WebUI, n8n, external-services
|
||||
├── infra/ # monitoring, nfs-provisioner (Traefik + MetalLB via helm au bootstrap)
|
||||
└── apps/ # Open WebUI, n8n, STT, Ghostfolio, external-services
|
||||
```
|
||||
|
||||
---
|
||||
|
|
@ -209,7 +212,7 @@ ansible-vault encrypt ansible/group_vars/all/vault.yml
|
|||
ansible-vault edit ansible/group_vars/all/vault.yml
|
||||
```
|
||||
|
||||
Variables stockées dans le vault : `vault_anthropic_api_key`, `vault_pg_hermes_password`, `vault_pg_litellm_password`, `vault_pg_n8n_password`, `vault_pg_openwebui_password`, `vault_postfix_relay_password`, `vault_n8n_api_key`.
|
||||
Variables stockées dans le vault : `vault_anthropic_api_key`, `vault_pg_hermes_password`, `vault_pg_litellm_password`, `vault_pg_n8n_password`, `vault_pg_openwebui_password`, `vault_pg_ghostfolio_password`, `vault_postfix_relay_password`, `vault_n8n_api_key`.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -228,7 +231,7 @@ Elle est gérée automatiquement par le rôle Ansible `llama_server`.
|
|||
## Roadmap
|
||||
|
||||
- [x] Ansible — storage-01 (gateway, NFS, PostgreSQL, Qdrant, LiteLLM, Hermes, postfix, AlertManager webhook)
|
||||
- [x] Ansible — gpu-01 (ROCm, llama-server ×3 — GPU + 2× CPU)
|
||||
- [x] Ansible — gpu-01 (ROCm, llama-server : GPU :1234 + embeddings :1238 via le rôle ; 2× CPU manuels)
|
||||
- [x] Stack IA opérationnelle (Hermes multi-profils + Qwen3 + Claude API)
|
||||
- [x] Délégation inter-agents (`ask-agent` + skill `agent-delegation`)
|
||||
- [x] RAG opérationnel — Qdrant 339 chunks, `rag-query` / `rag-ingest`
|
||||
|
|
@ -240,7 +243,10 @@ Elle est gérée automatiquement par le rôle Ansible `llama_server`.
|
|||
- [x] n8n (`n8n.lab.local`, namespace `ai`, 3 workflows actifs)
|
||||
- [x] Email sortant — Postfix relay → Gmail SMTP
|
||||
- [x] hermes-auto-improve — analyse quotidienne de la doc par Hermes (n8n 22h → PR `hermes/daily-work`)
|
||||
- [x] Ghostfolio — suivi de portefeuille (`ghostfolio.lab.local`, PostgreSQL s01 + Redis)
|
||||
- [x] STT — assistant vocal « Jarvis » (client `stt` + STT-server in-cluster, mémoire Qdrant `stt-memory`)
|
||||
- [x] Modèle d'embedding dédié — nomic-embed-text sur gpu-01 `:1238` (utilisé par la mémoire STT)
|
||||
- [x] Réparer Qdrant — crash-loop résolu 2026-06-17 (collection `funk-docs` supprimée → à re-ingérer)
|
||||
- [ ] Re-ingérer le RAG (`rag-ingest`) et le basculer sur l'embedding dédié `:1238`
|
||||
- [ ] WOL compute nodes (configuration BIOS)
|
||||
- [ ] Route statique Freebox
|
||||
- [ ] Modèle d'embedding dédié (nomic-embed-text ou bge-m3) pour améliorer le RAG
|
||||
- [ ] Réparer Qdrant (collection `funk-docs` corrompue depuis 2026-06-05) + re-ingest
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue