mirror of
https://github.com/Alkatrazz24/Funk-lab.git
synced 2026-07-10 06:24:42 +02:00
docs(stt): documenter le fix /no_think Qwen3 + instance embeddings :1238
- admin/ia/stt.md : caveat « thinking » Qwen3 (content vide / timeout 502) + fix /no_think + fallback reasoning_content ; roadmap 5e ; bannière. - stt/server/README.md : env STT_DISABLE_THINKING + section caveat Qwen3. - admin/ia/llama_server.md : 4e instance llama-embed :1238 (nomic, dim 768), double source d'embeddings (1234 Qwen3 / 1238 nomic), caveat thinking, correction dim Qwen3 (3584 → 4096). - admin/ia/litellm.md : cross-ref caveat thinking (concerne tous les consommateurs de hermes-default/qwen3). - ci : exclure **/*.md du trigger build-stt-server (doc-only ne rebuild plus). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013FmcxGsyXZXogiAHQLjnZT
This commit is contained in:
parent
c79c203970
commit
1340c36b16
5 changed files with 62 additions and 7 deletions
|
|
@ -1,21 +1,27 @@
|
|||
# llama-server — Inférence LLM (gpu-01)
|
||||
|
||||
llama-server (llama.cpp compilé with ROCm 7.x) tourne en **trois instances systemd** sur **gpu-01** (`192.168.10.20`).
|
||||
llama-server (llama.cpp compilé with ROCm 7.x) tourne en **quatre instances systemd** sur **gpu-01** (`192.168.10.20`).
|
||||
API 100% compatible OpenAI — remplace LM Studio pour l'inférence.
|
||||
|
||||
---
|
||||
|
||||
## Trois instances
|
||||
## Quatre instances
|
||||
|
||||
| Service systemd | Port | Modèle | Backend | Usage |
|
||||
|---|---|---|---|---|
|
||||
| `llama-server` | 1234 | Qwen3-8B Q4_K_M | GPU (RX 6700XT) | Inférence principale — Hermes + LiteLLM |
|
||||
| `llama-server-system` | 1236 | Qwen3-1.7B Q4_K_M | CPU | Profil Hermes `system` (tâches légères) |
|
||||
| `llama-server-monitor` | 1237 | Qwen3-1.7B Q4_K_M | CPU | Profil Hermes `monitor` (supervision) |
|
||||
| `llama-embed` | 1238 | nomic-embed-text-v1.5 f16 | GPU | Embeddings dédiés (mémoire STT, dim 768) |
|
||||
|
||||
Les instances CPU (`system`, `monitor`) partagent le même binaire mais des configs distinctes.
|
||||
Les modèles sont sur NFS monté depuis storage-01 (`/mnt/models`).
|
||||
|
||||
> `llama-embed` (`:1238`) est **géré par Ansible** (rôle `llama_server`, `llama_embed_enabled`) —
|
||||
> contrairement aux instances CPU (gap IaC, voir plus bas). Sert un modèle d'embedding **dédié**
|
||||
> (`nomic-embed-text`, dim 768), bien plus discriminant que Qwen3-8B réutilisé. Partage le GPU
|
||||
> avec `:1234` (~300 Mo VRAM).
|
||||
|
||||
---
|
||||
|
||||
## Service systemd
|
||||
|
|
@ -35,6 +41,11 @@ sudo journalctl -u llama-server-system -f
|
|||
sudo systemctl status llama-server-monitor
|
||||
sudo systemctl restart llama-server-monitor
|
||||
sudo journalctl -u llama-server-monitor -f
|
||||
|
||||
# Instance GPU — embeddings dédiés (nomic-embed-text :1238)
|
||||
sudo systemctl status llama-embed
|
||||
sudo systemctl restart llama-embed
|
||||
sudo journalctl -u llama-embed -f
|
||||
```
|
||||
|
||||
---
|
||||
|
|
@ -67,12 +78,29 @@ llama-server expose `/v1/embeddings` avec `--embeddings --pooling mean`.
|
|||
Le flag `--pooling mean` est obligatoire pour les LLM causaux (sinon : erreur 400
|
||||
`Pooling type 'none' is not OAI compatible`).
|
||||
|
||||
**Deux sources d'embeddings :**
|
||||
|
||||
| Endpoint | Modèle | Dim | Usage |
|
||||
|---|---|---|---|
|
||||
| `:1234/v1/embeddings` | Qwen3-8B (chat réutilisé) | 4096 | RAG (`funk-docs`) — peu discriminant |
|
||||
| `:1238/v1/embeddings` | nomic-embed-text (dédié) | 768 | Mémoire STT (`stt-memory`) — précis |
|
||||
|
||||
> Qwen3-8B n'est **pas** un modèle d'embedding dédié (cosinus uniformément hauts → recherche
|
||||
> peu discriminante). L'instance `llama-embed` (`:1238`) sert `nomic-embed-text`, spécialisé.
|
||||
> Le RAG pourra y basculer quand il sera réparé (voir `admin/ia/rag.md`).
|
||||
|
||||
```bash
|
||||
# Test embeddings depuis storage-01
|
||||
# Test embeddings dédiés nomic (:1238) — depuis le LAN cluster
|
||||
curl -s -X POST http://192.168.10.20:1238/v1/embeddings \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"model":"nomic-embed-text","input":["test"]}' | jq '.data[0].embedding | length'
|
||||
# → 768 (dimension nomic-embed-text-v1.5)
|
||||
|
||||
# Test embeddings Qwen3 (:1234) — RAG
|
||||
curl -s -X POST http://192.168.10.20:1234/v1/embeddings \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"model":"qwen3-8b","input":["test"]}' | jq '.data[0].embedding | length'
|
||||
# → 3584 (dimension Qwen3-8B)
|
||||
# → 4096 (dimension Qwen3-8B)
|
||||
```
|
||||
|
||||
---
|
||||
|
|
@ -197,6 +225,7 @@ Conséquence : un `make apply-gpu` complet sur un hôte vierge ne déploierait P
|
|||
| --metrics obligatoire | Sans ce flag, `/metrics` retourne `501 Not Implemented` — Prometheus ne scrappe rien |
|
||||
| parallel=1 obligatoire | `--parallel 4` divise le ctx en slots → contexte insuffisant pour Hermes |
|
||||
| pooling mean obligatoire | Sans `--pooling mean`, l'endpoint `/v1/embeddings` retourne erreur 400 |
|
||||
| Qwen3 = modèle « thinking » | Par défaut Qwen3 raisonne avant de répondre → consomme le budget `max_tokens` en `reasoning_content` (`content` vide) ou réfléchit longtemps (timeout). Ajouter **`/no_think`** au prompt système pour le désactiver. STT le fait (`STT_DISABLE_THINKING`) ; à considérer pour tout consommateur de Qwen3 à `max_tokens` faible (ask-agent, profils Hermes). |
|
||||
| Gemma 4 interdit | Crash ROCm sur prompts >800 tokens |
|
||||
| Modèles sur NFS | `/mnt/models` monté depuis storage-01 (NFS) — si NFS down, les 3 services échouent au démarrage |
|
||||
| 3 services indépendants | Chaque instance a son propre service systemd — redémarrer l'un n'affecte pas les autres |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue