Frank
3713339ffc
Uncommitted machine/session edits (live config, models, docs drift) were blocking the merge of origin/main. Committed as-is to preserve them; the merge that follows resolves overlapping prose files toward upstream canonical, with local variants recoverable from this commit. Pre-merge copies also in .AGENTTRASH/pre-merge-2026-10-18/.
51 lines
2.5 KiB
Markdown
51 lines
2.5 KiB
Markdown
# System Documentation
|
||
|
||
Hardware, operating system, and network documentation for the Frank Program
|
||
infrastructure. A client workstation runs the desktop stack; Dankserver and
|
||
Dankclaw are the inference servers it talks to.
|
||
|
||
## Local System
|
||
|
||
- [Network](/system/network.md) — LAN topology, and the client-side DNS pinning rule for workstations with both Wi-Fi and Ethernet.
|
||
- [Workstation stack](/tools/cachyos.md) — operating system, packages, and userspace; [niri](/tools/niri/index.md) for the compositor and display rig.
|
||
|
||
## Network Systems
|
||
|
||
- [Dankserver](/system/dankserver.md) — Main-model inference server at 192.168.0.235:7770, serving `frank-archon` (radiance Qwen3.8-Flash-Next, 200K ctx). AMD Ryzen 7 7700X, 2× Radeon AI PRO R9700, Ubuntu 26.04.
|
||
- [Dankclaw](/system/dankclaw.md) — Secondary inference + services box at 192.168.0.143: `frank-dragoon` (:7770, halogen-flash-server on the Strix Halo iGPU) and `frank-zealot` (:7771, llama.cpp on the RTX 3090). AMD Ryzen AI MAX+ 395, Ubuntu 26.04.
|
||
|
||
## Infrastructure Diagram
|
||
|
||
```mermaid
|
||
graph TB
|
||
subgraph Local[Workstation - CachyOS + Niri]
|
||
A[Niri Wayland]
|
||
B[Noctalia Shell]
|
||
C[Ghostty Terminal]
|
||
D[Pi Agent]
|
||
end
|
||
|
||
subgraph Network[192.168.0.0/24]
|
||
E[dankserver<br/>192.168.0.235:7770<br/>frank-archon]
|
||
F[dankclaw<br/>192.168.0.143:7770 dragoon<br/>:7771 zealot]
|
||
end
|
||
|
||
D --> E
|
||
D --> F
|
||
C --> D
|
||
B --> C
|
||
A --> B
|
||
```
|
||
|
||
## Related Knowledge Bases (sibling project repos)
|
||
|
||
The fleet has one sibling OKF knowledge base outside this bundle. Read it for
|
||
deployment and inference details. This bundle links to it from the server pages.
|
||
|
||
* **serverAppConfigs** — deploy repo + Obsidian vault, on this workstation at `~/Projects/serverAppConfig/` with docs in `~/Projects/serverAppConfig/serverAppConfigs-docs/` (root `index.md` at the vault top — the old `docs/` prefix is gone). Podman deployment configuration for both servers: compose/quadlet files, Caddy reverse proxy, deploy scripts, bats tests, and the vault service docs (Dankclaw, Dankserver, Architecture, Infrastructure) — **plus the LLM inference fleet** (merged from the former `vllmScripts` repo on 2026-08-22, history preserved): radiance frank-archon on Dankserver (:7770), halogen frank-dragoon (:7770) and llama.cpp frank-zealot (:7771) on Dankclaw. The vault's `LLM/` runbooks are the deploy-side source of truth; this bundle documents the agent/harness side.
|
||
|
||
## Related
|
||
|
||
- [Root Index](/index.md) — bundle navigation.
|
||
- [Engineering](/engineering/index.md) — best practices behind the ops.
|