System Documentation

Tech

Build 01 // Messbar dokumentiert

Meine technische Dokumentation — die Organe des Systems, wie ich sie als Erbauer sehe. Noch nicht vollständig, aber so strukturiert, dass ich jede neue Version von HUNTER ergänzen kann.

01 // Compute & Electronics

Hardware

Die Stückliste zeigt nicht nur Produkte, sondern ihren Zweck im System: Ein gebrauchtes Pixel 6a betreibt die Runtime, die Rii K06 liefert Eingabe und Touchpad.

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-Tastatur und Google Pixel 6a in einem realen 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-Druck

Das Gehäuse wird in Versionen dokumentiert. Dazu gehören Außenmaße, Einbauräume, Verschraubung, Material und die Druckparameter, die tatsächlich funktioniert haben.

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.

03 // Operating Layer

Software Stack

Termux bildet die mobile Basis; im PRoot-Ubuntu-Container laufen Gateway und Agent. tmux hält die Sessions, Cron und Watchdog sorgen für einen überprüfbaren Dauerbetrieb.

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

Die Runtime besteht aus mehr als einem Modell: Ziel, Tools, persistentes Wissen und Verifikation. Entscheidend ist ihre Resilienz gegen Androids Speicherverwaltung – Kills verhindern lässt sich nicht immer, aber ein einzelner Kill darf nicht alles stoppen.

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

Architektur

Die Ebenen bleiben getrennt: Hardware, mobile Linux-Basis, Agent und Interface. Dadurch kann ein interner Ticker ausfallen, ohne dass der externe Tick, die Jobs und die Verifikation verschwinden.

01Hardware
02System
03Agent
04Interface