Funk-lab/admin
ALI YESILKAYA 9fef555cc3
feat(stt): embeddings dédiés nomic-embed-text sur gpu-01 (:1238) + migration auto (#12)
* feat(stt): mémoire long-terme sémantique via Qdrant (5b)

Serveur : longterm.py — collection Qdrant stt-memory (embeddings Qwen3 gpu-01, dim auto,
Cosine), recall top-k injecté au prompt, remember des tours user. Tout dégrade proprement
si Qdrant/embeddings injoignables (la mémoire court-terme tient). Env STT_MEMORY_LONGTERM,
STT_QDRANT_URL, STT_EMBED_URL, STT_MEMORY_TOPK.

Testé en process : dégradation OK (Qdrant down → mem=0, pas de crash, court-terme tient).
Qdrant réparé le 17/06 (5c). Recherche sémantique réelle à valider sur cluster.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT

* feat(stt): endpoint /v1/memory/health + upsert Qdrant synchrone

- /v1/memory/health sonde activement embeddings + Qdrant + collection et
  expose les erreurs (recall/remember dégradent en silence → indébogables).
  Permet de diagnostiquer la mémoire long-terme sans kubectl exec.
- remember() : upsert avec ?wait=true → le souvenir est immédiatement
  cherchable (sans wait, Qdrant met l'écriture en file → un recall
  cross-session immédiat pouvait le rater).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT

* docs(stt): 5b mémoire long-terme validée en prod + backlog nomic-embed-text

- Rappel cross-session confirmé (« Felix » retrouvé dans une nouvelle session),
  points_count vérifié via /v1/memory/health.
- Note du fix upsert ?wait=true et de l'endpoint de diagnostic.
- Roadmap : 5d (nomic-embed-text dim 768) en backlog qualité ; états haut/bas
  du doc mis à jour (déployé + validé sur cible).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT

* feat(stt): embeddings dédiés nomic-embed-text sur gpu-01 (:1238) + migration auto

Remplace Qwen3 (chat réutilisé, dim 4096, peu discriminant) par un modèle
d'embedding spécialisé nomic-embed-text (dim 768) pour la mémoire long-terme.

Ansible (rôle llama_server) :
- nouvelle instance optionnelle `llama-embed` (llama_embed_enabled) servant un
  modèle d'embedding dédié sur :1238, GPU ; télécharge le GGUF si absent.
- activée sur gpu-01 (host_vars) : nomic-embed-text-v1.5 f16.

STT-server :
- STT_EMBED_URL → :1238, STT_EMBED_MODEL → nomic-embed-text (deployment + config).
- _ensure_collection détecte le changement de dimension (4096→768) et recrée
  automatiquement la collection stt-memory (anciens vecteurs incomparables) —
  pas de drop manuel.

Docs : llama_server README, rag.md, stt.md (5d ), CLAUDE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-06-17 21:54:41 +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): embeddings dédiés nomic-embed-text sur gpu-01 (:1238) + migration auto (#12) 2026-06-17 21:54:41 +02:00
infra docs(email): masquer exemple App Password dans la doc 2026-05-17 16:54:20 +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(n8n): rapports portefeuille — news en FR + piège apostrophe JS + édition via API 2026-06-16 13:24:21 +02:00
ops docs(ansible): README par rôle (19) + gaps IaC découverts à l'audit 2026-06-10 15:21:24 +02:00
funk-cluster docs(admin): add ops documentation and fix hermes dashboard service 2026-05-12 18:50:43 +02:00
incidents.md docs: synchroniser la doc avec l'état réel du cluster (revue Ansible + incident Qdrant) 2026-06-10 15:11:53 +02:00
index_knowledge.py docs: mise à jour documentation — NVMe, Qwen3, gaps IaC 2026-05-30 22:58:24 +02:00
README.md docs: réorganisation complète de admin/ en 4 domaines thématiques 2026-05-14 00:47:58 +02:00

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
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

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

ia/ — Stack IA Funk

Fichier Contenu
ia/llama_server.md llama-server — 3 instances (GPU+CPU), 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

incidents.md

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