From b9c4199bb5c96ac96d40672ecfde03d535f4fc6d Mon Sep 17 00:00:00 2001 From: claude-code Date: Sun, 19 Apr 2026 12:41:24 -0600 Subject: [PATCH] Initial wiki landing page --- Home.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 Home.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..0559473 --- /dev/null +++ b/Home.md @@ -0,0 +1,25 @@ +# ai-kraken + +A NixOS live USB that boots a Windows workstation into a headless **AI mode**. + +## What it is + +- Target hardware: Windows machine with RTX 3080 Ti, 128 GB RAM +- Boot medium: USB stick (UEFI, Secure Boot off) +- Runtime: NixOS live environment, headless, SSH-only +- Workload: Ollama (CUDA) serving 7B-class models +- Storage model: MinIO on the LAN is the source of truth; models land in `tmpfs` during a session + +## Design + +See the design document in the main repo: `docs/specs/2026-04-19-nixos-ai-live-usb-design.md`. + +## Wiki sections (planned) + +- **Runbook** — how to boot, SSH in, pull a model, recover from common failures +- **MinIO bucket layout** — conventions for `models//model.gguf` + `Modelfile` +- **BIOS prerequisites** — Secure Boot, BitLocker suspension, boot order +- **Build & flash** — from scratch on a new laptop +- **Model catalog** — which 7B quants are known to work well on the 3080 Ti + +These get filled in as the project takes shape.