# vLLM Scripts

Deployment scripts for the LLM inference fleet (2026-08-18 topology):
upstream llama.cpp on Dankserver and CIRU ROCmFPX llama.cpp on Dankclaw.

## Targets

| Host | User | Codename | GPU |
|------|------|----------|-----|
| dankserver | dank | Dankserver | NVIDIA RTX 3090 24 GB + 62 GB RAM |
| dankclaw | dank | Dankclaw | AMD Strix Halo iGPU gfx1151 (unified memory) |

## Active Services

| Service | Host | Runtime | Model | Port |
|---------|------|---------|-------|------|
| frank-default-small | dankserver | llama.cpp (upstream b10121) | HauhauCS Qwen3.6-35B-A3B-Uncensored-Aggressive Q6_K_P + ngram-mod, 36 MoE experts on CPU, 4 slots x ~175K ctx | 7770 |
| frank-default-large | dankclaw | CIRU ROCmFPX llama.cpp (ROCm 7.15 SDK) | jcbtc Qwen3.8-27B-CIRU-ActiveFPX-PromptForge v2, native MTP + PromptForge DualView, 262K ctx / 1 slot | 52625 |

The 2026-08-17 redo retired the pipeline-parallel split (PP head + RPC
worker) and the FastFlowLM NPU endpoint. The 2026-08-18 swap retired the
vLLM service on Dankclaw and renamed the services (see AGENTS.md). Their
scripts are preserved in `old/scripts/` for reference.

## Structure

- `docs/` — knowledge base: deployment runbook, model notes, research archive
- `scripts/` — serve scripts, env files, systemd units, deploy and test tools
- `old/scripts/` — retired PP/NPU-era scripts (reference only)

## Deployment

See [docs/deployment.md](docs/deployment.md). Run
`FRANK_SUDO_PW=... ./scripts/deploy.sh dankserver` for the llama.cpp box or
`FRANK_SUDO_PW=... ./scripts/deploy.sh dankclaw` for the CIRU box.

## Knowledge Base

See [docs/index.md](docs/index.md) for the project knowledge base index.