Files
Frank 3713339ffc chore: adopt pre-existing working-tree state before trunk merge
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/.
2026-10-18 16:46:57 -07:00

2.5 KiB
Raw Permalink Blame History

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 — LAN topology, and the client-side DNS pinning rule for workstations with both Wi-Fi and Ethernet.
  • Workstation stack — operating system, packages, and userspace; niri for the compositor and display rig.

Network Systems

  • Dankserver — 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 — 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

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

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.