Frank
02883d3ed2
Copy of the legacy ~/.pi/agent/docs tree rebuilt as the command-center knowledge base: concept files promoted to path identity, index listings stripped of frontmatter, all wikilinks/relative links resolved, every checkable claim verified against the live fleet (Dankserver = Ryzen 7 7700X + RTX 3090; Strix Halo is Dankclaw), unverifiable claims tagged. kb-lint exits 0.
53 lines
2.6 KiB
Markdown
53 lines
2.6 KiB
Markdown
# System Documentation
|
|
|
|
Hardware, operating system, and network documentation for the Frank Program
|
|
infrastructure. dankware is the primary workstation; Dankserver and Dankclaw are
|
|
the llama.cpp inference servers it talks to.
|
|
|
|
## Local System
|
|
|
|
- [System Overview](/system/dankware/index.md) — dankware: Alienware m16 R2 laptop running CachyOS with Niri Wayland.
|
|
- [Hardware Specifications](/system/dankware/hardware.md) — CPU, GPU, memory, storage, network controllers, and PCI devices for dankware.
|
|
- [Display Configuration](/system/dankware/displays.md) — Three-monitor setup: dual Samsung Odyssey G75F (portrait) plus the internal BOE panel.
|
|
- [Network Interfaces](/system/dankware/network.md) — Wi-Fi (Intel BE202), built-in Ethernet (Killer E3000), USB Ethernet, and local network topology.
|
|
|
|
## Network Systems
|
|
|
|
- [Dankserver](/system/dankserver.md) — Primary llama.cpp inference server at 192.168.0.235:7770, serving `frank-default-small` (163,840-token context). AMD Ryzen 7 7700X, RTX 3090, Ubuntu 26.04.
|
|
- [Dankclaw](/system/dankclaw.md) — Secondary inference server at 192.168.0.143:7770, serving `frank-default-large` (262,144-token context). AMD Ryzen AI MAX+ 395 (Strix Halo), Ubuntu 26.04, ROCm.
|
|
|
|
## Infrastructure Diagram
|
|
|
|
```mermaid
|
|
graph TB
|
|
subgraph Local[dankware - Alienware m16 R2]
|
|
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-default-small]
|
|
F[dankclaw<br/>192.168.0.143:7770<br/>frank-default-large]
|
|
end
|
|
|
|
D --> E
|
|
D --> F
|
|
C --> D
|
|
B --> C
|
|
A --> B
|
|
```
|
|
|
|
## Related Knowledge Bases (sibling projects on dankware)
|
|
|
|
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** — `/home/dank/Projects/serverAppConfigs/` (index: `/home/dank/Projects/serverAppConfigs/docs/index.md`). Podman deployment configuration for both servers: compose files, Caddy reverse proxy, deploy scripts, bats tests, and the Obsidian-vault service docs (Dankclaw, Dankserver, Architecture, Infrastructure) — **plus the LLM inference fleet** (merged from the former `vllmScripts` repo on 2026-08-22, history preserved): llama.cpp on Dankserver (:7770, `frank-default-small`) and CIRU ROCmFPX llama.cpp on Dankclaw (:7770, `frank-default-large`). LLM fleet docs: `docs/LLM/index.md`; deploy runbook: `docs/LLM/deployment.md`.
|
|
|
|
## Related
|
|
|
|
- [Root Index](/index.md) — bundle navigation.
|
|
- [Engineering](/engineering/index.md) — best practices behind the ops.
|