From a7062d1cb31879dd3562a2922b5e84212ea91129 Mon Sep 17 00:00:00 2001 From: Frank Date: Mon, 19 Oct 2026 03:16:48 -0700 Subject: [PATCH] docs(frank-zealot): carry the 3 x 200,704 shape, retire the exact-KV era row The endpoint page owns its shape: the flags row, the budget equation behind it (25,088 B/token, 14,406.00 MiB of cache + 2,352.00 MiB of draft cache inside 24,123 MiB addressable), the "MTP is ON" section replacing the "OFF by measurement" one, the harness contract at the per-slot 200,704, and the fallback rungs rewritten as deltas FROM the shipped shape. The 2026-10-18 exact-KV boot (KV 16,384.00 / RS 100.50 / compute 1,408.06 + 1,088.07 / mmproj 868.32 charged after the fit check, settled 21,176/2,949) and its contended rate floors move into that era's Eras row with the one-line rollback, so the two pages that carried them collapse to one. Rates for the new shape are deliberately absent - no bench was ordered, and the fit gate, the health gate and the boot ledger are the evidence a swap needs. AGENTS.md follows the same numbers: contextWindow 200704 is the per-slot window and the trio's shape line. --- AGENTS.md | 18 +++-- serverAppConfigs-docs/LLM/frank-zealot.md | 93 ++++++++++------------- 2 files changed, 52 insertions(+), 59 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 98e80aa..aa2d72f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -384,10 +384,11 @@ the publisher's own **Q8_0** mmproj passed as `--mmproj` — Q8_0 is the publisher's requirement for concurrent image requests (the card states the BF16 tower can crash `llama-server` when several image requests run at once, and this endpoint runs several slots). `frank-zealot`'s `contextWindow` is -**262144** — the PER-SLOT window (`--ctx-size 524288 --parallel 2` since the -2026-10-18 reslice to exact f16 KV), which EQUALS the model's -native window; llama.cpp answers a longer prompt with a 400 naming the limit, -never a truncation, so the harness must compact before it. +**200704** — the PER-SLOT window (`--ctx-size 602112 --parallel 3` since the +2026-10-19 reslice that funded a third slot AND an armed MTP drafter), +deliberately below the model's native window; llama.cpp answers a longer prompt +with a 400 naming the limit, never a truncation, so the harness must compact +before it. Note also that the reasoning channel differs by runtime: llama.cpp AND SGLang (qwen3 @@ -435,10 +436,11 @@ disagrees with it is the bug. loader ignoring that metadata dequantizes wrong); payload `Bonsai2-9B-MTP/…PQ2_0.gguf` + the publisher's **Q8_0** mmproj (the BF16 tower can crash the server with concurrent image requests). -- Shape: `--ctx-size 524288 --parallel 2` = **two conversations at the - model's native 262,144**, `CACHE_TYPE_K/V=f16`, batch 4096 / ubatch 2048, - `SPEC_TYPE=none`, `--flash-attn on`, `--jinja`, `--metrics`. -- Harness/gate contract: `contextWindow: 262144` is the **per-slot** window +- Shape: `--ctx-size 602112 --parallel 3` = **three conversations at + 200,704 each**, `CACHE_TYPE_K=f16` + `CACHE_TYPE_V=q8_0` (asymmetric: 25,088 + B/token, 14,406 MiB of pool), batch 6144 / ubatch 1024, + `SPEC_TYPE=draft-mtp` (depth 2), `--flash-attn on`, `--jinja`, `--metrics`. +- Harness/gate contract: `contextWindow: 200704` is the **per-slot** window (`n_ctx_slot = CTX_SIZE / PARALLEL`), and llama.cpp answers a longer prompt with a 400 rather than truncating. `--metrics` is mandatory or Prometheus reads 501 = DOWN beside a healthy service. Presence penalty has no GGUF diff --git a/serverAppConfigs-docs/LLM/frank-zealot.md b/serverAppConfigs-docs/LLM/frank-zealot.md index 5028636..5d2221f 100644 --- a/serverAppConfigs-docs/LLM/frank-zealot.md +++ b/serverAppConfigs-docs/LLM/frank-zealot.md @@ -1,6 +1,6 @@ --- type: reference -title: "frank-zealot on Dankclaw — llama.cpp (PrismML fork 10777), Ternary-Bonsai-2-9B PQ2_0-MTP, 2 × 262144, exact f16 KV" +title: "frank-zealot on Dankclaw — llama.cpp (PrismML fork 10777), Ternary-Bonsai-2-9B PQ2_0-MTP, 3 × 200704, f16 K + q8_0 V, MTP armed" description: "The one frank-zealot reference: the live shape on Dankclaw's RTX 3090 (:7771) exactly as scripts/frank-zealot.env ships it, every era with its rollback path, the deduplicated laws of this card, the wire contract, and the owning files." tags: - llm @@ -12,10 +12,11 @@ tags: timestamp: 2026-10-18 --- -# frank-zealot — llama.cpp (PrismML) Bonsai-2-9B PQ2_0-MTP, 2 × 262,144, exact f16 KV +# frank-zealot — llama.cpp (PrismML) Bonsai-2-9B PQ2_0-MTP, 3 × 200,704, f16 K + q8_0 V, MTP armed Dankclaw's RTX 3090 endpoint — `http://192.168.0.143:7771`, wire id `frank-zealot`, the fleet's **compaction hub** -(widest window it has). One page per endpoint: eras are rows below, not pages. Siblings: [[frank-archon]], +(three conversations at 200,704 each, the window the other two endpoints also cap at). One page per +endpoint: eras are rows below, not pages. Siblings: [[frank-archon]], [[frank-dragoon]]. Deploy with `./scripts/deploy.sh dankclaw --service frank-zealot`; swap mechanics in [[Model Swap and Rollback]], sizing math in [[Llama Cpp Serving Sizing]]. `scripts/frank-zealot.env` and `scripts/serve-frank-zealot.sh` are the authority for the shape; where any prose disagrees with them, the prose @@ -31,72 +32,62 @@ is the bug. | Runtime | `/home/dank/GitPackages/llama-prism-b10777/llama-server` — PrismML **fork**, `0.2.0-dev (build 10777, commit e3de71522)`; the only loader for this payload | | Trio | `scripts/frank-zealot.service` (root, relinked, `User=dank`, `Restart=on-failure`, `RestartSec=10`, `LimitMEMLOCK=infinity`, `TimeoutStopSec=180`) · `scripts/frank-zealot.env` · `scripts/serve-frank-zealot.sh` | | Address / alias | `BIND_ADDR=0.0.0.0`, `LISTEN_PORT=7771`, `ALIAS=frank-zealot` (a flag, not a fact) | -| Flags | `--ctx-size 524288 --parallel 2` ⇒ 262,144 per slot · `--cache-type-k f16 --cache-type-v f16` (exact, **16,384 MiB**) · `--flash-attn on` · `--batch-size 4096 --ubatch-size 2048` · `--n-gpu-layers 99` · `--jinja --reasoning auto --reasoning-format deepseek` · `--metrics` · `--mmproj` · `--log-verbosity 4` · `--presence-penalty 1.0` · **`SPEC_TYPE=none`** | +| Flags | `--ctx-size 602112 --parallel 3` ⇒ 200,704 per slot · `--cache-type-k f16 --cache-type-v q8_0` (asymmetric, **14,406.00 MiB**) · `--flash-attn on` · `--batch-size 6144 --ubatch-size 1024` · `--n-gpu-layers 99` · `--jinja --reasoning auto --reasoning-format deepseek` · `--metrics` · `--mmproj` · `--log-verbosity 4` · `--presence-penalty 1.0` · **`--spec-type draft-mtp`** with `--spec-draft-n-max 2 --spec-draft-n-min 0 --spec-draft-p-min 0` | **Why this shape.** `general.architecture qwen35`: 33 blocks (32 trunk + `blk.32` = the MTP block), `full_attention_interval 4` ⇒ 8 full-attention + 24 Gated DeltaNet, 4 KV heads × 256 dim, `nextn_predict_layers 1` (the head **is in the file**), trained window 262,144, `general.sampling.*` 1.0/0.95/20. Only the 8 full layers bill -per token (32,768 B at exact f16 ⇒ 16,384 MiB over the pool) and the DeltaNet layers add ~50 MiB of recurrent state -**per slot**: exact KV costs the third conversation and nothing else. +per token and the DeltaNet layers add ~50 MiB of recurrent state **per slot**, so the shape is a single budget +equation at 25,088 B/token (f16 K 16,384 + q8_0 V 8,704): **14,406.00 MiB** of cache over a 602,112 pool + +**2,352.00 MiB** of draft cache (blk.32 at its own f16 rate, billed over the WHOLE pool) + ~7.7 GiB of weights, +projector, buffers and states, inside the 24,123 MiB the driver leaves addressable. Exact V (32,768 B/token ⇒ +18,816 MiB here) buys neither the third conversation nor the drafter; the fully quantized pair (17,408 B/token) +buys both and costs the keys their precision. -**MTP is OFF by measurement, not by absence of a head.** The drafter is *good* — 2026-10-18 measured -acceptance 0.798 / 0.617 per position, mean accepted length 2.41, and the publisher's card says depth 2 works -best — and it still loses here, because the draft context is built against the *target's* pool: `blk.32` bills -4,096 B/position at its default f16 ⇒ 2,048 MiB at 524,288 positions on a trunk that projects 21,234 MiB of the -24,123 MiB addressable (that projection predicts 2,889 MiB free; replace it with the measured pair). Exact KV and a -drafter cannot share this card. `--spec-draft-type-k`/`--spec-draft-type-v` (default f16, verified in this build's -`--help`) would cut the draft to 1,088 MiB — legal on b10777, **never booted beside exact KV**. There is no -`--spec-draft-model`: the MTP draft rides the main model's weights. The env carries the recipe -(`SPEC_DRAFT_N_MAX=2`, `SPEC_DRAFT_N_MIN=0`, `SPEC_DRAFT_P_MIN=0`); `SPEC_TYPE=none` never sends it. +**MTP is ON (Frank, 2026-10-19).** The drafter was always good — 2026-10-18 measured acceptance 0.798 / 0.617 per +position, mean accepted length 2.41, and the publisher's card says depth 2 works best — and arming it is a +budget decision, not a flag: the draft context is built against the *target's* pool, so `blk.32` bills 4,096 +B/position (2,352.00 MiB at 602,112) plus ~0.45 GiB of buffers at this ubatch and its own recurrent cells. +`CACHE_TYPE_V=q8_0` (−3,840 MiB against exact V at this pool) and `UBATCH_SIZE=1024` (−~1,306 MiB of compute +buffers, and the rung every measured MTP arm here ran on) are what pay for it; `UBATCH_SIZE=2048` beside an armed +drafter is the shape that halved decode (167.2 → 109.2 t/s). `--spec-draft-type-k`/`--spec-draft-type-v` (default +f16, verified in this build's `--help`) would cut the draft's bill again and stay at their default; there is no +`--spec-draft-model` — the draft rides the main model's weights, so a draft file would load the trunk twice. +`SPEC_TYPE=none` is the rollback and strips the whole set. **Harness contract** (`~/.omp/agent/models.yml`, provider `llamacpp (dankclaw-3090)`, id `frank-zealot`): -`contextWindow: 262144` — **the per-slot window**, because llama.cpp divides `--ctx-size` across slots and answers a +`contextWindow: 200704` — **the per-slot window**, because llama.cpp divides `--ctx-size` across slots and answers a longer prompt with a 400, never a truncation — plus `maxTokens: 16384`, `input: [text, image]`, `compat.reasoningContentField: reasoning_content`, `compat.reasoningEffortMap` (**load-bearing**: the template takes only `xhigh|medium|low` and raises on anything else), `extraBody` 1.0 / 0.95 / 20 / `min_p 0`, and the `compactionModel` of [[frank-archon]], [[frank-dragoon]] **and** frank-zealot all pointing here. -**The exact-KV boot, measured** (2026-10-18 evening, under the unit, verbosity 4). KV **16,384.00 MiB** = -32,768 B/token × 524,288 positions, to the MiB — rate derivation and ledger agree with no slop, which is what -buries the doc's old "f16 needs 26,112 MiB and cannot boot" figure for good: that was the 27B's 34,816 B/token -applied to the 9B. RS **100.50 MiB** (2 cells, one 50.25 MiB cell lighter than the q8_0 era), compute -1,408.06 + 1,088.07 CUDA_Host, mmproj worst case **868.32 MiB** charged *after* the engine's own fit check, -settled `nvidia-smi` **21,176 used / 2,949 free** of 24,123, `n_slots = 2`, `n_ctx_slot = 262144`, -`DropInPaths` empty, no clamp line, no `cudaMalloc` error — within 24 MiB of the pre-flight projection. That is -a desktop margin: the ~2 GiB of slack is what an image storm has to live inside. - -**Rates on this shape are FLOORS, not the shape's rates** — measured the same evening greedy with `ignore_eos` -at 512 tokens, first request discarded, while another consumer drove the other slot (56 new prompts in three -minutes, 96 % GPU-util): the exact condition the bench window exists to exclude, and one contended deep arm -even came back truncated (a 512 KB body accepted as `prompt_n = 4`). - -| Arm | q8_0 3-slot record | f16 2-slot, contended | -|---|---|---| -| single-stream decode | 168.7 | **134.1 – 141.5** (145.8 and 163.2 in a lighter minute) | -| concurrent aggregate | ≈300 across 3 (102.8 each) | **256.6 / 262.4 / 265.1** across 2 (≈128–133 each) | -| prefill at ~106k | 2,877 at 106,418 | **3,159.5 at 106,282** | -| decode at 106k depth | never measured | **71.5** | - -What the floors already support: per-conversation concurrency **improved** (two streams hold ~130 t/s each where -three held 102.8), endpoint aggregate sits ~12 % under the 3-slot record, prefill beat the record while -contended, and single-stream decode is between parity and −20 %. The 1.882× KV byte bill is real; its true size -on this card is still unmeasured, so quoting 134 or 163 t/s as "the" number is a guess in either direction — -re-run the same arms with the box quiet before a figure is carried anywhere else. +**This shape ships unbenchmarked, by law.** Frank ordered the reslice, not a +number, so the evidence a swap needs is the seam's fit gate (it prices cache + +draft cache + recurrent states against the 24,123 MiB the driver leaves +addressable, and refuses the two boots this shape can walk into: exact V with the +drafter armed, and the retired dtype pair at the retired pool), the deployer's +health gate, and the first verbosity-4 ledger of the new dtype pair — which is +recorded on this page because projections drift, and nowhere else. The previous +era's exact-KV boot and its rate floors live in that era's row below; those floors +were measured while another consumer drove the other slot (56 prompts in three +minutes, 96 % GPU-util), the exact condition a bench window exists to exclude. **Fallback rungs**, cheapest first — one line of `frank-zealot.env` each, and each must keep the seam's fit gate green: -| Knob | Effect | +| Knob | Effect from the shipped shape | |---|---| -| `UBATCH_SIZE=1024` | hands back 1,306 MiB of compute buffers; prefill −17 %; it is also the arm that ran the drafter at three windows (213.5 t/s) | -| `CACHE_TYPE_V=q8_0` | exact K + quantized V: KV 16,384 → **12,544 MiB**, freeing 3,840 (llama.cpp has no true fp8 KV dtype — q8_0 is the 8-bit class) | -| `CTX_SIZE=401408` | two 200,704 conversations, exact KV at 12,544 MiB (same 3,840 freed) — `contextWindow` MUST follow the per-slot number | -| `CTX_SIZE=786432 PARALLEL=3 CACHE_TYPE_K/V=q8_0` | the era below this one: 13,056 MiB of cache, the third conversation back | -| `CACHE_TYPE_K/V=q4_0` | 10,240 B/token ⇒ 5,120 MiB (the 27B era measured q4_0 at 16,392 used / 7,733 free at 2 × 200,704) | +| `SPEC_TYPE=none` | the drafter off: hands back 2,352 MiB of draft cache plus its buffers and recurrent cells, at the cost of the ~+28 % decode the 2026-10-18 census measured whenever the card has room | +| `UBATCH_SIZE=2048` | +~1,306 MiB of compute buffers and +4.6 % prefill — and the rung that HALVED decode beside an armed drafter (167.2 → 109.2 t/s) | +| `CTX_SIZE=401408` | two 200,704 conversations: frees 4,802 MiB of cache — `contextWindow` MUST follow the per-slot number | +| `CACHE_TYPE_V=f16` | exact V: +4,410 MiB at this pool with the drafter armed, which is a `cudaMalloc` death the seam refuses — legal only once the drafter or a slot is gone | +| `CACHE_TYPE_K=q8_0` | the fully quantized pair (17,408 B/token): frees 4,410 MiB and moves the quantization error into the keys | ## Eras | Window | Payload | Runtime | Shape | Replaced because | Rollback | |---|---|---|---|---|---| +| 2026-10-18 21:06 → 2026-10-19 | the same 9B MTP file and projector | PrismML fork 10777 | 2 × 262,144 (pool 524,288), exact f16 K+V = 16,384.00 MiB, `SPEC_TYPE=none`, batch 4096 / ubatch 2048; boot ledger KV 16,384.00 / RS 100.50 / compute 1,408.06 + 1,088.07 CUDA_Host / mmproj worst case 868.32 charged after the fit check, settled **21,176 used / 2,949 free**, `n_ctx_slot = 262144`, within 24 MiB of the projection; floors 134.1–141.5 t/s single-stream, 256.6–265.1 aggregate over two, 3,159.5 t/s prefill at 106,282, 71.5 t/s decode at 106k depth (contended — floors, not the shape's rates) | Frank ordered the third conversation back AND the drafter armed, and exact V funds neither: it bills 18,816 MiB at the pool that pays for the third slot, leaving nothing for the draft's 2,352 | one line each — `CTX_SIZE=524288 PARALLEL=2 CACHE_TYPE_V=f16 BATCH_SIZE=4096 UBATCH_SIZE=2048 SPEC_TYPE=none` — and redeploy; no payload move | | 2026-10-18 13:19 → same evening (the boot `68afc6d` replaced) | the same 9B MTP file and projector | PrismML fork 10777 | 3 × 262,144 (pool 786,432), q8_0 K+V = 13,056 MiB, settled 17,956 / 6,169 MiB; 168.7 t/s decode (three runs 168.4–168.7), ~300 t/s over three streams (102.8 each), 2,877 t/s prefill at 106,418 | Frank ordered unquantized KV, and that pool cannot survive it: 24,576 MiB of f16 cache > 24,123 addressable | one env line — `CTX_SIZE=786432 PARALLEL=3 CACHE_TYPE_K/V=q8_0` — and redeploy; no payload move | | 2026-10-18, 24 min (arm under the unit) | `Bonsai2-PTQ1_0/Ternary-Bonsai-2-27B-PTQ1_0.gguf` 5,946,648,928 B + hardlinked Q8 mmproj | PrismML fork 10777 | 2 × 200,704, batch/ubatch 3072/1536 | Frank scratched the 27B plan — ~48 t/s decode vs 76.6 for PQ2_0 on the same weights | `/home/dank/models/Bonsai2-PTQ1_0/` + `scripts/download-frank-zealot-bonsai2-ptq1.sh` | | 2026-10-17 → 10-18 | Ternary-Bonsai-2-**27B** PQ2_0 7,206,168,928 B `3907dc16…` + Q8_0 mmproj 629,246,976 B | PrismML fork **10754** (`~/GitPackages/llama-prism/`) | 2 × 200,704 (pool 401,408), q8_0 K+V = 13,328 MiB, settled 22,664 / 1,461; 76.6 t/s decode, 109.4 aggregate over two streams, 691.7 t/s prefill at 166,027; MTP impossible — no head in the file | the 9B bills half the KV per token (8 full layers, not 16), which funded three slots at the native window and beat it on every rate | `/home/dank/models/Bonsai2-PQ2_0/` + the 10754 fork tree, `scripts/download-frank-zealot-bonsai2.sh`, revert the swap commit | @@ -160,7 +151,7 @@ re-run the same arms with the box quiet before a figure is carried anywhere else ## Contract -- `/health` → `{"status":"ok"}`; `/props` reports `n_ctx` and `presence_penalty`; `/slots` shows occupancy; a third +- `/health` → `{"status":"ok"}`; `/props` reports `n_ctx` and `presence_penalty`; `/slots` shows occupancy; a fourth concurrent conversation **waits** for a slot — the slot count is the concurrency contract. - `/metrics` answers 200 with 15 `llamacpp:*` families **only with `--metrics`**; without it llama.cpp answers **501**, which Prometheus reads as DOWN while `/health` stays 200. The scrape target is `host.containers.internal:7771/metrics` and the oldest retained sample of `up{job="frank-zealot"}` (2026-10-11) is already 0 — this target was never successfully scraped, across every payload era. `METRICS=0` is the documented opt-out and re-breaks it; the counters cost nothing on the request path. - Reasoning arrives in **`reasoning_content`** (`--reasoning-format deepseek`) and **counts against `max_tokens`**: a short budget yields empty `content` with `finish_reason: "length"`, which reads as a broken model, not a mid-thought one. The slot prefix cache is live (`cached_tokens` in `usage`). @@ -168,9 +159,9 @@ re-run the same arms with the box quiet before a figure is carried anywhere else (1.0 / 0.95 / 20). `presence_penalty` is the one recipe value with no GGUF metadata key, so it must reach argv; the serve script uses `${PRESENCE_PENALTY=1.0}`, deliberately **not** `:=`, because `""` is the documented opt-out. - Vision: only the OpenAI **`image_url`** content part reaches the model — the legacy top-level `images` field bumps `usage.prompt_tokens` while the model invents an answer. Probe with a **≥ 256 px** solid color (a postage stamp answers "video") and budget **≥ 512** tokens; a 512 px image bills ~280 prompt tokens. -- **Q8_0 mmproj, not BF16**: the publisher warns the BF16 tower "can crash llama-server when several image requests run at once", which is exactly the `--parallel 2` shape. `MMPROJ_FILE=` (explicitly empty) is the text-only opt-out and returns ~1.4 GiB; a path at a missing file is a boot **refusal**, never silent blindness. +- **Q8_0 mmproj, not BF16**: the publisher warns the BF16 tower "can crash llama-server when several image requests run at once", which is exactly the `--parallel 3` shape. `MMPROJ_FILE=` (explicitly empty) is the text-only opt-out and returns ~1.4 GiB; a path at a missing file is a boot **refusal**, never silent blindness. - Tools: native via `--jinja`; `finish_reason: tool_calls` with valid JSON arguments. -- Two non-faults: a `400` naming 262,144 is one conversation outgrowing its **slot**, not pool exhaustion; and +- Two non-faults: a `400` naming 200,704 is one conversation outgrowing its **slot**, not pool exhaustion; and the raw `/completion` path is a **dead instrument on this fork build** — a greedy `ignore_eos` run answers **500 "The model produced output that does not match the expected Content-only format"**, because build 10777 guards the raw path the moment reasoning markup leaks (older builds only logged `failed to parse reasoning