Docs

The technical docs

Every claim on the front page, with the document behind it and the day it was measured.

ZoeyOS is two halves on one machine. The Wall is the part you look at and talk to. The krew is the part that works the board while you are away. The diagram shows what goes where, which port each piece answers on, and what leaves the machine.

What goes where in a ZoeyOS install Two columns on one machine: ZoeyOS on the left (the Wall, the Control Panel, the ear, the voice by machine tier, the oracle, the aligner) and the krew on the right (one Hermes gateway, the kanban board and its agents, the two language-model lanes, memory). Between them the agent endpoint. Under both, what stays on the box and what leaves only when asked. One machine. Two halves. One endpoint between them. Everything below listens on loopback. Ports are the defaults; a launcher can move them all at once. ZoeyOS, on the machine The Wall, the player :8100 her face and mouth, the page, /frame.mjpg, the verbs Control Panel Standard · Secure · Secure held · Voice on/off · Dev Ear mic → VAD + speaker stamp :8190 → ARK-ASR on the CPU :8096 Voice, by machine tier NVIDIA GPU Chatterbox Turbo → Pocket → text strong CPU Audio8 → Pocket → text Mac, 16 GB+ Audio8 → Pocket → say → text weak, 8 GB Mac Pocket → Kokoro → say → text any OpenAI-style speech endpoint also fits :8189 Oracle, optional :8197 face check at the desk, door feed; voice only backs the face Word aligner :8195 the mouth clock: words land where they are said krew, the agents One Hermes gateway every profile served at /p/<name>, each with its own key The board (kanban) Ada routes · Bash + Steward build · Lila researches Vera reviews · Judge one verb · Scout notes Zoey rules the Decide queue; the owner is last resort loops: green → reframe → retreat; done · park · later gates every 2 min (no model); the loop every 20 (model) nightly: research → debate → rank → vote → one card Two language-model lanes, one GPU ops :8000 Zoey's reply brain, the voice corner crew :8005 the workers' lane; Qwen3.8-27B on both Memory :8888 Hindsight: what the team learned, recalled on demand Patrols Janitor 5 min · keeper · hold sweep · nightly M&S + security The agent endpoint /connect any OpenAI-style chat endpoint /v1/ask /v1/speak MCP server krew plugin: wall_* loopback only the ear's turns → /v1/ask her answer → the voice Stays on the box speech in and out, the model weights, the transcripts face and voice prints, who is home, the board and its cards the memory, the daily report, every loop pack you install no telemetry, no update checks, no account; served pages load nothing external Leaves, only when asked a search or page read an agent makes after authority, through your own relay; one kill-search switch stops it your click on the store or the Composer link (a page of ours) library sync is off by default; a bought pack is a file you download and drop in yourself
Sources: the speech architecture (measured 2026-10-07), the security summary, the loop pack format and the player pack README, the outbound-calls inventory (2026-10-02), and the merge state of 2026-10-08 for the voice tiers. The weak-machine voice tier is in the pack source and not yet merged into the house.

Hardware and software

Security and the house

Not a SOC 2 report and not a claim of immunity. Where a number came from a command, the source document names the command.