System Documentation

Tech

Build 01 // Measured and documented

My technical documentation — the system's organs as I see them as its builder. Not complete yet, but structured so every new HUNTER version can be added.

01 // Compute & Electronics

Hardware

The bill of materials shows purpose, not just products: a used Pixel 6a runs the runtime, while the Rii K06 provides keyboard and touchpad input.

ComputePixel 6a · 45 €

128 GB Speicher und 6 GB RAM für Termux, PRoot-Ubuntu, Gateway und Agent Runtime – ohne Root.

InterfaceRii K06 + Touchpad

Kompakte Eingabe für Terminal, Kontrolle und direkte Rückmeldung am Deck.

PowerMobile Versorgung

Die Energieversorgung ist auf einen nutzbaren, mobilen Dauerbetrieb und einen sauberen Shutdown ausgelegt.

ConnectivityWLAN & Bluetooth

Netzwerkzugriff für Tools und lokale Geräte; die Runtime bleibt dabei auf dem mobilen Knoten.

Rii K06 mini keyboard and Google Pixel 6a in a real HUNTER hardware setup Input + Mobile Node // Field Kit
Core Interface

Rii K06 +
Pixel 6a

Ein gebrauchtes Pixel 6a betreibt im Termux-Umfeld einen Hermes-Agenten. Die Rii K06 bildet die kompakte Bedienebene mit Tastatur und Touchpad.

Input
Rii K06
Storage
128 GB
Memory
6 GB RAM
02 // Industrial Design

Case & 3D printing

The case is documented version by version: outer dimensions, clearances, fasteners, material and print settings that actually worked.

FormatModularer Aufbau

Komponenten sollen austauschbar bleiben, ohne das gesamte Case neu zu drucken.

FilesFinale STL-Dateien

9 freigegebene Druckdateien für V14, V6, Ringstand V2 und das optionale +1-mm-Clip-Upgrade.

View 3D models
03 // Operating Layer

Software stack

Termux is the mobile base; the gateway and agent run inside a PRoot-Ubuntu container. tmux keeps sessions alive, while cron and the watchdog make continuous operation verifiable.

BaseTermux + PRoot-Ubuntu

Mobile Linux-Umgebung ohne Root, mit klar getrennter Agent- und Systemebene.

Servicestmux Gateway

Geplante Aufgaben warten im Gateway; ein Watchdog überwacht den Herzschlag.

Control8 Cron-Jobs

Lebenszeichen, 30-Minuten-Health-Check und tägliche Berichte – bisher ohne fehlgeschlagene Jobs.

ReleaseBash statt Token

Der Status- und Recovery-Teil läuft mit Bash, ohne laufende Modellkosten.

04 // Intelligence Layer

Agent runtime

The runtime is more than a model: goals, tools, persistent knowledge and verification. Resilience against Android memory management matters; kills cannot always be prevented, but one kill must not stop everything.

ReasoningHermes plant, pi baut

Im Multi-Agent-Workflow plant Hermes, pi implementiert und Hermes verifiziert unabhängig.

ContextHolographic Memory

HUNTERs Memory fasst nur 2.200 Zeichen — deshalb habe ich ein Holographic-Gedächtnis ergänzt: eine lokale SQLite-Datenbank ohne Limit. Dazu fünf Sicherheitsschichten, damit nichts verloren geht: AGENTS.md bei jedem Erwachen, die Obsidian-Vault als Gehirn, Skills als prozedurales Wissen und eine Volltextsuche über alle vergangenen Gespräche. Ein Background-Review lernt aus den Fehlern des Systems — reaktiv, nicht proaktiv. Den Unterschied habe ich beim Betrieb selbst erfahren.

ActionExterner Cron-Tick

Der Tick feuert aus Termux unabhängig vom internen Gateway-Thread.

SurvivalSemantischer Watchdog

Prüft Herzschlag, letzten erfolgreichen Tick und überfällige Jobs – mit 30-Minuten-Cooldown gegen Restart-Loops.

Runtime // Toolchain

Der aktive Agent Stack

Gemessen: 83+ Stunden Uptime und 0 OOM-Kills seit dem Fix. Die ehrliche Grenze bleibt: Bei Speicherdruck gewinnt Android; das System ist darauf ausgelegt, Kills zu überstehen.

Agent // SurvivalSurvival Layer

Ich habe drei Schichten gebaut, damit HUNTER Androids Speicherverwaltung übersteht. Erstens: ein externer Cron-Tick aus Termux, der unabhängig vom internen Scheduler-Thread feuert — stirbt der Ticker, laufen die Jobs trotzdem. Zweitens: ein semantischer Watchdog, der nicht fragt „läuft der Prozess?“, sondern „arbeitet das System wirklich?“ — Herzschlag, letzter erfolgreicher Tick, überfällige Jobs, mit 30-Minuten-Cooldown gegen Restart-Loops. Drittens: bewusste RAM-Disziplin — Browser nur manuell, kurz, bei genug freiem Speicher.

Gemessen: 83+ Stunden Uptime, 0 OOM-Kills seit dem Fix am 28.08. Ehrliche Grenze: Bei Speicherdruck gewinnt Android immer. HUNTER ist darauf gebaut, Kills zu überstehen — nicht sie zu verhindern.

05 // System Flow

Architecture

The layers stay separate: hardware, mobile Linux base, agent and interface. An internal ticker can fail without taking down the external tick, jobs or verification.

01Hardware
02System
03Agent
04Interface