# vLLM Scripts — Knowledge Base

Documentation for the LLM inference fleet on two local machines
(2026-08-22): upstream llama.cpp on Dankserver (frank-default-small) and
CIRU ROCmFPX llama.cpp with the PromptForge v3 runtime on Dankclaw
(frank-default-large).

## Deployment Topology

```mermaid
graph LR
    subgraph Dankserver[NVIDIA Dankserver - Ubuntu 26.04]
        A[RTX 3090 24GB + 62GB RAM]
        B[upstream llama.cpp b10121
frank-default-small, port 7770]
        C[Qwen3.6-35B-A3B-Uncensored Q6_K_P
ngram-mod, 36 MoE experts on CPU, 700K ctx]
        A --> B --> C
    end

    subgraph Dankclaw[AMD Strix Halo - Ubuntu 26.04]
        D[gfx1151 iGPU 64 GiB unified memory]
        E[CIRU ROCmFPX llama.cpp PromptForge v3
frank-default-large, port 52625]
        F[jcbtc Qwen3.8-27B-CIRU-ActiveFPX-PromptForge v3
262K ctx / 1 slot, full-W8 views, Output-K8 MTP, BF16 vision]
        D --> E --> F
    end

    I[LLM Clients / API] -->|HTTP :7770| B
    I -->|HTTP :52625| E
```

## Servers

| Server                                  | GPU                           | VRAM / Memory        | OS           |
| --------------------------------------- | ----------------------------- | -------------------- | ------------ |
| [[Dankserver System Specs\|Dankserver]] | NVIDIA RTX 3090               | 24 GB VRAM, 62 GB RAM | Ubuntu 26.04 |
| [[Dankclaw System Specs\|Dankclaw]]     | AMD Radeon 8060S (Strix Halo) | gfx1151 unified memory | Ubuntu 26.04 |

## Active Deployment

- [[deployment]] — deploy and update process for both servers
- [[frank-redo-2026-08-17]] — the 2026-08-17 topology change
- [[ciru-activefpx-promptforge]] — the v3 CIRU PromptForge runtime on
  Dankclaw (frank-default-large, active; restored 2026-08-22)
- [[kairic-edge]] — the retired Kairic Edge IU4 experiment
  (deployed and reverted 2026-08-22)
- [[Dankserver]] — the upstream llama.cpp box (frank-default-small)
- [[Dankclaw]] — the CIRU ROCmFPX box (frank-default-large)

## CIRU Reference (Dankclaw)

- [[ciru-activefpx-promptforge]] — the v3 model, ROCm 7.15 toolchain,
  and build history (active deployment)
- [[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 (the model family now served by frank-default-small as
  Q6_K_P)

## 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-default-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 of multi-node inference research. The PP
  pair is retired; these pages are research history.

## Sibling projects

- [serverAppConfigs](../serverAppConfigs/docs/index.md) — the Podman app
  stack on the same two hosts. Its OpenWebUI consumes the `:7770` endpoint
  on Dankserver; its Gitea instance hosts this repository.