Files
serverAppConfigs/serverAppConfigs-docs/LLM/index.md
T
Frank 49e8dfff66 docs: the vault and AGENTS.md describe two Dankclaw endpoints
halogen-flash-server is ACTIVE again with its 2026-09-16 measured ledger (budget
33.5 GiB against a need of 27.2 — no clamp — and 14.7 GiB left for everything
else), ik_llama.cpp is retired with its measurements kept as the record of why,
and the new frank-small runbook covers the -mtp file, the 64 KiB/token KV
arithmetic, the MTP contract, and the reasoning_effort trap that cost me every
subagent on the endpoint.

AGENTS.md: topology, Active Services, runbook index, and three new llama.cpp
lessons (MTP is a property of the file; --jinja is what `tools` needs; a model's
template can reject the harness's thinking level). Three pre-existing defects
found while editing it: a truncated sentence mid-file, a harness path that does
not exist on either server, and the benchmarking stop/mask recipe still calling
frank-large a root unit.

Truthfulness notes worth keeping: the co-tenant stall NOTE prints again, so the
claim that it "no longer prints" is gone and the three observed block counts are
recorded instead of a guessed threshold; and the Observability page says out
loud why frank-large has no scrape job rather than leaving a silent absence.
2026-09-16 14:52:51 -07:00

9.0 KiB
Raw Blame History

LLM Fleet — Knowledge Base

Documentation for the LLM inference fleet on the two hosts (2026-09-16): vllm-radiance on Dankserver (frank-medium, just1moremodel Qwen3.8-27B-Uncensored-MXFP4-awq on 2x Radeon AI PRO R9700) and TWO endpoints on Dankclaw — halogen-flash-server (frank-large, Qwen3.8-Flash-Next w4b on the gfx1151 iGPU, port 7770) and mainline llama.cpp (frank-small, ISTA-DASLab Qwen3.8-27B-GSQ-RCO IQ3_S with MTP and vision on the RTX 3090, port 7771).

2026-08-22: the former vllmScripts repository is merged into the serverAppConfigs repository. This knowledge base moved from the old repo's serverAppConfigs-docs/ root to serverAppConfigs-docs/LLM/. The fleet scripts and units now live in the repo's scripts/ directory.

Deployment Topology

graph LR
    subgraph Dankserver[AMD Dankserver - Ubuntu 26.04]
        A[2x Radeon AI PRO R9700
gfx1201, 32 GiB each]
        B2[vllm-radiance MXFP4
frank-medium, port 7770]
        C[Qwen3.8-27B-Uncensored-MXFP4-awq
2 single-GPU replicas, 114688 ctx / 4 seqs, DFlash2]
        A --> B2 --> C
    end

    subgraph Dankclaw[AMD Strix Halo - Ubuntu 26.04]
        E2[RTX 3090 (PCIe x4 dock) +
gfx1151 iGPU 64 GiB unified memory]
        E[halogen-flash-server 0.5.8
frank-large, port 7770]
        F[peonist-ai Qwen3.8-Flash-Next w4b
2 x 200192 ctx over one 400384-position pool]
        G[mainline llama.cpp 37b53fd
frank-small, port 7771]
        H[Qwen3.8-27B GSQ-RCO IQ3_S
131072 ctx / 1 slot, MTP + vision]
        E2 --> E --> F
        E2 --> G --> H
    end

    CLI[LLM Clients / API] -->|HTTP :7770| B2
    CLI -->|HTTP :7770| E
    CLI -->|HTTP :7771| G

## Servers

| Server                                  | GPU                           | VRAM / Memory        | OS           |
| --------------------------------------- | ----------------------------- | -------------------- | ------------ |
| [[Dankserver System Specs\|Dankserver]] | 2x AMD Radeon AI PRO R9700 | 2x 32 GB VRAM, 60 GB RAM | Ubuntu 26.04 |
| [[Dankclaw System Specs\|Dankclaw]]     | AMD Radeon 8060S (Strix Halo) | gfx1151 unified memory | Ubuntu 26.04 |

## Active Deployment

- [[frank-medium-radiance-mxfp4]] — the ACTIVE frank-medium runbook: the
  vllm-radiance MXFP4 stack (stilldeadcode/vllm-radiance:0.9.3 +
  ggz14/radiance-vllm-mxfp4 patches) serving
  just1moremodel/Qwen3.8-27B-Uncensored-MXFP4-awq on Dankserver's 2x Radeon
  AI PRO R9700 as two single-GPU replicas behind a round-robin proxy, with
  the PCIe-atomics evidence that rules out TP=2 on this host (since
  2026-09-15/16)
- [[frank-medium-rocmfpx]] — PRIOR frank-medium deployment (llama.cpp era,
  2026-09-15): charlie12345/ROCmFPX serving
  kingjones777/Qwen3.8-27B-ROCmFPX-Q8_0-AGENT-GGUF; kept as the record of the
  runtime it replaced
- [[freetoken-frank-small]] — RETIRED 2026-09-15, when the RTX 3090 moved to
  frank-large: the FreeToken v0.1.2 frank-small runbook (batsclamp
  Huihui-Qwen3.6-35B-A3B-abliterated-FP8), kept as the retirement record. The
  NAME was reused on 2026-09-16 by a different service on Dankclaw — see
  [[frank-small-qwen38-gsq-rco]]
- [[freetoken-benchmark-sweep]] — KV pool vs decode speed sweep
  (bs1/bs3/bs4/bs6, 8k–700k KV) on Dankserver RTX 3090
- [[deployment]] — deploy and update process for both servers
- [[frank-redo-2026-08-17]] — the 2026-08-17 topology change
- [[halogen-flash-server]] — ACTIVE frank-large runbook again since 2026-09-16
  (rootless Quadlet, port 7770): peonist-ai halogen-flash-server 0.5.8 serving
  peonist-ai/halogen-qwen3.8-flash-next (Qwen3.8-Flash-Next w4b .hgn + quality
  overlay) on the gfx1151 iGPU — two 200k conversations over one
  400,384-position pool, deployed flags, memory model, client contract,
  troubleshooting
- [[frank-small-qwen38-gsq-rco]] — ACTIVE frank-small runbook since 2026-09-16
  (root systemd unit, port 7771): mainline llama.cpp serving
  ISTA-DASLab/Qwen3.8-27B-GSQ-RCO IQ3_S on the RTX 3090, with the model's own
  Multi-Token Prediction head for speculative decoding and the BF16 projector
  for the fleet's image path
- [[frank-large-ik-uncensored]] — RETIRED 2026-09-16 (rollback target): the
  ik_llama.cpp runbook (root systemd unit, 2026-09-15 → 09-16) serving
  mradermacher/Qwen3.8-Flash-Next-Uncensored-i1-Q4_K_M on the RTX 3090
  (dense/attention/KV) + LPDDR (experts/PLE) hybrid; its measured envelope and
  decode root-cause chain are the record of why the fleet went back to halogen
- [[dankclaw-iommu-translation-off]] — why Dankclaw boots with
  `amd_iommu=off` since 2026-09-11 (13-16 % prefill, measured upstream),
  what it cost (the NPU endpoint), what was deliberately not copied from
  the reference machine, and how to revert
- [[kingjones-strix-rocmfp4]] — PRIOR frank-large runbook and rollback
  target: kingjones777/Qwen3.8-Flash-Next-ROCmFP4-STRIX-GGUF, 177B params
  (56B MoE + 51.2B PLE), single 113.47 GiB GGUF, on the card's pinned
  kingjones30/ROCmFPX fork (2026-08-30 → 2026-09-11)
- [[ubatch-benchmark-large]] — active-model llama-bench ubatch sweep plan and results
- [[kingjones-q8agent-rocmfpx]] — the retired Q8_0-AGENT investigation and `set_rows` failure
- [[eemin-rocmi4-mtp]] — the former caf-eemin Qwen3.8-27B embedded-MTP model
  on Dankclaw (retired)
- [[dealign-ornith-crack]] — the retired Ornith-1.5-35B-A3B CRACK model on
  Dankserver (frank-small, retired 2026-09-02)
- [[ikllama-ornith-dankserver]] — the retired ik_llama.cpp runtime for
  frank-small (2026-08-26): q8_0 + Hadamard KV cache,
  split-mode none (single-GPU), mandatory FA_ALL_QUANTS build flags
- [[kingjones-strix-mtp]] — the former Q6 AGENT runbook (restored 2026-09-01
  after Q8_0 failure, then superseded by the STRIX deployment on 2026-08-27)
- [[ciru-activefpx-promptforge]] — the RETIRED v3 CIRU PromptForge runtime
  on Dankclaw (superseded 2026-08-24 by the kingjones ROCmFP4 model)
- [[kairic-edge]] — the retired Kairic Edge IU4 experiment
  (deployed and reverted 2026-08-22)
- [[Dankserver System Specs]] — the 2x R9700 box (frank-medium)
- [[Dankclaw System Specs]] — the Strix Halo gfx1151 box (frank-large on
  halogen-flash-server since 2026-09-16, frank-small on the RTX 3090)
- [[frank-npu]] — RETIRED 2026-09-11: the FLM NPU sight+sound endpoint
  on Dankclaw (Gemma4 E4B vision+audio pack, XDNA2, port 7771), kept as
  the retirement record — the IOMMU/SVA err=-19 root cause and where
  every dependent route moved

## CIRU Reference (Dankclaw)

- [[ciru-activefpx-promptforge]] — the RETIRED v3 model, ROCm 7.15 toolchain,
  and build history (on Dankclaw; the slot now serves the kingjones
  ROCmFP4 model, see [[kingjones-strix-mtp]])
- [[kairic-edge]] — Kairic Edge IU4 runtime: build runbook, binary
  identity, and experiment summary (retired 2026-08-22)

## DFlash2 Reference (archived)

- [[dflash2-large-vulkan]] — the retired DFlash2 Vulkan deployment
  (2026-08-21)

## vLLM Reference (historical)

- [[VLLM Overview]] — installation, CLI, API, architecture, quantization, parallelism
- [[VLLM Index]] — quick reference with commands, endpoints, and parameter table
- [[Running Qwen3.6 35B A3B FP8 on Dankserver]] — Qwen3.6-35B-A3B hardware
  notes and sizing (this architecture family is what the retired frank-small
  served in the Huihui abliterated FP8 variant — see
  [[freetoken-frank-small]]; the Ornith-1.5-35B-A3B CRACK checkpoint
  that preceded it is archived at [[dealign-ornith-crack]])

## Memory Management

- [[RAM CPU Offloading in VLLM]] — KV cache swap between GPU VRAM and system RAM
- [[Hybrid CPU GPU Processing Dankserver]] — NVIDIA GPU compute with system RAM offload
- [[Shared Memory Architecture Dankclaw]] — AMD unified memory and ROCm configuration

## Retired Topology (2026-08-17 redo)

- [[Qwen3.8 PP Deployment]] — the retired pipeline-parallel head + worker
- [[qwen3.8-spec-matrix]] — Qwen3.8-27B spec history (superseded by FastMTP)
- [[FastFlowLM NPU Inference]] — the retired FastFlowLM NPU endpoint
- [[frank-large-benchmark]] — backend/spec benchmark behind the old head
- [[dankserver-vram-growth]] — VRAM/RAM growth behind the retired cuBLAS crash
- [[DFlash DSpark Speculative Decoding]] — retired DFlash/DSpark drafting
- [[Quantization by Hardware Architecture]] — which quant format fits which GPU/CPU

## Pipeline Parallelism (archive)

- [[Pipeline Parallelism/index]] — index of multi-node inference research. The PP
  pair is retired. These pages are research history.

## Runtime Research (llama.cpp family)

- [[Llama Cpp Runtimes]] — mainline vs charlie12345/ROCmFPX vs ik_llama.cpp: positioning, quantization, server fit
- [[Llama Cpp Code Diff]] — code-level quantization diff of the three runtimes + server recommendations
- [[SGLang]] — the structured-generation serving engine; when it fits Dankserver (2x R9700) vs Dankclaw (Strix Halo)

## Related

- [Project knowledge base](../index.md) — the Podman app stacks on the same
  two hosts. OpenWebUI (Dankclaw) consumes the on-host `frank-large`
  endpoint at `:7770`. The Gitea instance on Dankclaw hosts this repository.
- [Deployment Flow](../Architecture/Deployment%20Flow.md) — the service-scoped
  git-based deploy with inference isolation