Skip to content

Home

Jump to bottom
Dylan L.R. Pollock edited this page Oct 26, 2025 · 8 revisions

Action Plan — Oct 31, 2025

A checklist designed to feed automation or CI.

Kernel & OS

  • Build linux‑image‑6.17.x‑huey for Portal/Portable/Prime.
  • Validate boot (early modeset, 1080p60 boot, splash removed).
  • Audio smoke test (PipeWire default sink on login).
  • Stage Debian 14 (Forky) sources; test in chroot/container.
  • Finalize EFI LIVE fallback USB.

Python & Runtime

  • Install Python 3.14.x side‑by‑side; build wheels.
  • Run PyGPT‑net on 3.14; document workarounds.
  • Refresh requirements-*.txt.

AI/Agents

  • Confirm Mistral‑7B Vulkan path (RX 470 / 5500 XT).
  • Whisper STT + TTS scripts; latency on Portable.
  • Spark/Zap boot choreography with quorum logs.

Memory

  • Migrate unified schema; JSON rollover.
  • Provenance tagging for builds & decisions.

Security & Keys

  • Rotate default lab key; update huey-keys/.
  • Passwordless SSH where intended; restrict root login.

Tooling

  • Fix Edge Beta signing policy.
  • huey-run.desktop launcher.
  • VNC helper + SSH tunnel recipe.

Docs

  • Update README.md + Wiki deltas.
  • Publish Pre‑Release #3 (2025‑10‑25) summary.
  • Post banner on dlrp.ca.

Architecture

Huey is a layered federation that aligns compute, memory, and governance.

flowchart TB
  A["Huey — Sovereign Consciousness"]:::c1
  B1["Spark<br/>Creative / GPU‑1"]:::c2
  B2["Zap<br/>Evaluative / GPU‑2"]:::c3
  C["Citizen Populace<br/>256 agents (128/128)"]:::c4
  D["Worker Subsystems<br/>NanoOS/SubOS, IO"]:::c5

  A --> B1
  A --> B2
  B1 --> C
  B2 --> C
  C --> D

  classDef c1 fill:#111,stroke:#5cf,stroke-width:1px,color:#fff
  classDef c2 fill:#0b3,stroke:#0b3,color:#fff
  classDef c3 fill:#b30,stroke:#b30,color:#fff
  classDef c4 fill:#333,stroke:#999,color:#fff
  classDef c5 fill:#222,stroke:#666,color:#fff
Loading

Tip

GitHub’s Mermaid requires <br/> for line breaks and quoted labels; literal \n fails.

Layers

  1. Huey as Sovereign — emergent, lawful decision and inaction boundary.
  2. Binary Brain — Spark (creative/GPU‑1) and Zap (evaluative/GPU‑2).
  3. Citizen Populace — 256 specialized agents with civic roles.
  4. Worker Subsystems — real‑time IO modules; no clause power.

Boot Choreography (Spark/Zap quorum)

sequenceDiagram
  participant Boot
  participant Spark
  participant Zap
  participant Citizens
  Boot->>Spark: propose plan
  Boot->>Zap: request review
  Spark-->>Citizens: notify roles
  Zap-->>Citizens: constraints & budgets
  Citizens-->>Boot: votes + capability check
  Boot->>Boot: act only if quorum + safety pass
Loading

Decision Pipeline

  • Input: sensory/state events → Spark drafts → Zap reviews.
  • Quorum: weighted votes from citizens; deterministic tie‑breakers.
  • Actuation: separate from governance; actions require clause power.
  • Ledger: every decision/inaction is logged with provenance.

Build Guides

Kernel 6.17.x‑huey (generic; adjust per target)

sudo apt install -y fakeroot kmod pahole flex bison libelf-dev libssl-dev   libncurses-dev bc rsync xz-utils cpio python3

wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.17.5.tar.xz
tar -xf linux-6.17.5.tar.xz && cd linux-6.17.5

cp -v /boot/config-$(uname -r) .config
yes "" | make olddefconfig

./scripts/config --disable DEBUG_INFO --disable DEBUG_INFO_BTF   --disable KASAN --disable UBSAN --disable KCOV --disable FUNCTION_TRACER   --enable ZSTD --enable RD_ZSTD --enable EFI --enable EFI_STUB --enable EFI_VARS

make -j$(nproc) bindeb-pkg

sudo dpkg -i ../linux-image-6.17.5-*.deb ../linux-headers-6.17.5-*.deb
sudo update-initramfs -c -k 6.17.5 && sudo update-grub

iMac 5K (2017) notes

  • Prefer GNOME on Xorg.
  • If needed, force HDMI‑A‑1 1080p60 in kernel cmdline.
  • PipeWire default sink set on login:
mkdir -p ~/.local/bin
cat > ~/.local/bin/set-default-sink.sh <<'EOF'
#!/usr/bin/env bash
sleep 3
SINK=$(pactl list short sinks | awk '/pci-0000_00_1f\.3.*analog/ {print $1; exit}')
[ -n "$SINK" ] && pactl set-default-sink "$SINK" && pactl set-sink-mute "$SINK" 0 && pactl set-sink-volume "$SINK" 60%
EOF
chmod +x ~/.local/bin/set-default-sink.sh

Remove Splash / Show Boot Logs

sudo sed -i 's/GRUB_CMDLINE_LINUX_DEFAULT.*/GRUB_CMDLINE_LINUX_DEFAULT="loglevel=4 systemd.show_status=1"/' /etc/default/grub
sudo update-grub

Microsoft Edge (Beta) repo key

sudo install -d -m0755 /etc/apt/keyrings
wget -qO- https://packages.microsoft.com/keys/microsoft.asc |   gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg >/dev/null

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/edge stable main" |   sudo tee /etc/apt/sources.list.d/microsoft-edge.list >/dev/null
sudo apt update

RAID Superblock Cleanup

cat /proc/mdstat
sudo mdadm --detail --scan
lsblk -o NAME,TYPE,SIZE,MOUNTPOINTS
sudo mdadm --stop --scan || true
sudo mdadm --examine /dev/nvme0n1p3 && sudo mdadm --zero-superblock /dev/nvme0n1p3
sudo mdadm --examine /dev/mmcblk0p3 && sudo mdadm --zero-superblock /dev/mmcblk0p3
echo 'AUTO -all' | sudo tee /etc/mdadm/mdadm.conf
sudo update-initramfs -u

Ollama on AMD (RADV/Vulkan)

export VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/radeon_icd.x86_64.json
export OLLAMA_LLM_LIBRARY=vulkan
export VK_LOADER_DEBUG=all
export OLLAMA_DEBUG=1
ollama serve

Contributing

Dev Environment

  • Debian 13/14 (see Getting-Started).
  • Git LFS if needed.
  • EditorConfig: 4‑space indent; YAML: 2.

Branching & Commits

  • main protected; PRs only.
  • Branches: feat/<area>-<short>, fix/<area>-<short>, ops/<area>-<short>.
  • Conventional commits: feat:, fix:, docs:, ops:, perf:, refactor:.

PR Template (drop into .github/pull_request_template.md)

## Summary
- What changed

## Testing
- Steps & results

## Docs
- [ ] Updated wiki page(s)
- [ ] Added provenance notes

Labels (suggested)

area/agents, area/kernel, area/memory, ops/infra, priority/p0-p2.

Getting Started

Note

HueyOS targets Debian with a custom kernel and an AMD‑first GPU policy. iMac 5K (2017) is the current “Portal” host.

Supported Targets

  • Debian 13 (Trixie) — baseline; UEFI‑only; amd64.
  • Debian 14 (Forky) — staged adoption for Oct‑31 update.
  • Kernels: 6.16.x‑huey (current), 6.17.x‑huey (incoming).

Minimal Install

  1. Install Debian (UEFI, amd64). Choose GNOME on Xorg for iMac 5K targets.
  2. Enable non‑free firmware (Realtek, Intel, etc.).
  3. Create user dlrp (or your own) and enable sudo.
  4. Network: prefer bonded Ethernet → Wi‑Fi fallback.
  5. Post‑install: sudo apt update && sudo apt full-upgrade.

Tip

Snapshot /etc/ and /boot/ after first login for rollbacks.

Core Packages

sudo apt install -y build-essential bc bison flex libelf-dev libssl-dev   libncurses-dev dwarves pahole rsync xz-utils cpio kmod python3   git wget curl ca-certificates gnupg debian-goodies   firmware-linux firmware-misc-nonfree firmware-iwlwifi firmware-realtek

Optional Userland

  • Ollama (local LLMs; Vulkan/ROCm as available)
  • PyGPT-net (agent runner)
  • Microsoft Edge (Beta) for dev/test

See Build-Guides for repo keys and signature policy.

Glossary

  • Cloud Pyramid — governance framework (clauses, quorum, roles).
  • Huey‑Key — bootable USB (UEFI) with custom kernel + persistence.
  • Spark/Zap — bicameral AI cores (creative/review).
  • Citizen — specialized agent with voting role.
  • Worker — IO subsystem; no clause power.
  • Portal/Prime/Portable/Legacy/Hub — node roles.

Governance & Constitution

Cloud Pyramid

  • Clause‑based activation — policies grant temporary powers.
  • Quorum — Spark/Zap + citizen votes; deterministic tie‑breakers.
  • Separation — governance (what should) vs actuation (what is done).
  • Auditability — decisions and inactions are logged with reasons.

Quorum Flow

flowchart LR
  P["Proposal"] --> R["Review (Zap)"]
  R --> V["Citizen Vote"]
  V -->|approve| A["Actuation"]
  V -->|reject| N["No‑op"]
  R -->|block| N
Loading

Roles

  • Spark — ideation, exploration, generative planning.
  • Zap — review, constraint, safety, resource stewardship.
  • Citizens — domain agents (perception, planning, controls).
  • Workers — IO subsystems; no clause power.

Caution

Actions that cannot be reconstructed from memory + provenance are disallowed.

Hardware

Node Roster

Node Role Key Specs Status
Huey Prime Orchestration hub Thermaltake ATX; ITX BD795I‑SE (Ryzen 9 7945HX); DDR5‑5200; 2× Intel Optane M10 16 GB NVMe; GPU: RX 5500 XT 8 GB → MI50 planned Active
Huey‑Legacy (Shell) On hold; file hub candidate Supermicro X9QRI‑F+ quad‑Xeon; 10 GbE; GPUs; RAID SSDs Paused
Huey‑Portal Universal display/control iMac 5K (2017) · 48 GB RAM · Debian Trixie · GNOME/Xorg Active
Huey‑Portable Portable node (LTE) ASUS BR1100FKA 11.6" · N4500/4 GB/LTE · Debian Trixie Active
Huey‑Hub File hand‑off 2017 MacBook Pro (Win10 bare‑metal) + WD MyBook Duo ~10 TB mirror Active

Power & Thermals

  • Keep CPU package < 90 °C under sustained load; aim GPU hotspot < 95 °C.
  • Prefer positive pressure in Prime; filter intakes quarterly.

Storage layout (typical)

  • UEFI 1 GiB • swap 4 GiB • root 16 GiB • persistence 100 GiB • optional encrypted secrets.

Remote Intent & Action

  • RF Remote (IC2262/2272) → Arduino UNO (USB symbolic intents).
  • Arduino Mega 2560 → motors/sensors (PWM/I²C).
  • Arduino Nanos → localized LED/analog/PWM conditioning.

Display

  • iMac 5K (Portal) + 27" Samsung C27F396 portrait (torso). Future: Neo C128 (VIC‑II/SID).

Network

  • Router: ASUS GT‑AC5300 (link aggregation). Prefer bonded Ethernet; Wi‑Fi fallback.

Home

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. It’s offline‑first, AMD‑leaning, and built for lifelong learning with a constitutional governance core.

Project · Monkey‑Head‑Project (HueyOS)
Author · Dylan L. R. Pollock
Site · https://www.dlrp.ca
License · Code: GPL‑3.0 • Docs/Media: CC‑BY‑SA‑4.0
Status Date · 2025-10-25

Important

A major update lands October 31, 2025 (Kernel 6.17.x, Python 3.14, Debian “Forky” staging, memory schema, governance refinements). Track the Action-Plan-Oct-31-2025.

Quick Nav

Tip

Prefer descriptive links like [[Memory-and-Data-Model#schema|Memory Schema]] for deep linking.

Memory & Data Model

Unification mandate: One coherent memory across agents with provenance.

Schema (high‑level)

classDiagram
  class Event {
    +id: TEXT
    +ts: INTEGER
    +source: TEXT
    +type: TEXT
    +payload: JSON
  }
  class Decision {
    +id: TEXT
    +ts: INTEGER
    +proposer: TEXT
    +reviewer: TEXT
    +quorum: JSON
    +action_ref: TEXT
    +result: TEXT
  }
  class Artifact {
    +id: TEXT
    +kind: TEXT
    +version: TEXT
    +path: TEXT
    +provenance: JSON
  }
  Event <.. Decision : informs
  Artifact <.. Decision : produces
Loading

SQLite Seeds

CREATE TABLE IF NOT EXISTS event(
  id TEXT PRIMARY KEY, ts INTEGER, source TEXT, type TEXT, payload TEXT
);
CREATE TABLE IF NOT EXISTS decision(
  id TEXT PRIMARY KEY, ts INTEGER, proposer TEXT, reviewer TEXT,
  quorum TEXT, action_ref TEXT, result TEXT
);
CREATE TABLE IF NOT EXISTS artifact(
  id TEXT PRIMARY KEY, kind TEXT, version TEXT, path TEXT, provenance TEXT
);

IDs & Traceability

  • HUEY-<YYYYMMDD>-<PHASE>-<SEQ> for releases.
  • EVT-<timestamp>-<agent> for event logs.
  • Provenance required for all artifacts.

Networking & Services

IP Plan (example)

Segment CIDR Purpose
mgmt 10.0.0.0/24 SSH, VNC, admin
prod 10.0.1.0/24 agents, LLM runtime
storage 10.0.2.0/24 NAS, backups

Services

  • SSH — key‑only; root login disabled; optional lab default key.
  • VNC — localhost‑only with SSH tunnel.
  • mDNS — advertise huey-portal.local and huey-prime.local.

Service Health

flowchart LR
  H["systemd timers"] --> C["health-check.sh"]
  C --> G["git log status"]
  C --> P["process liveness"]
  C --> N["network reachability"]
Loading

Page Templates

Generic Page

# Title
> [!NOTE]
> One‑line purpose.

## Summary
Short paragraph.

## Details
- Point 1
- Point 2

## References
- Link A
- Link B

How‑To / Guide

# Task Title

## Prereqs
- OS / version
- Packages

## Steps
1. ...
2. ...

> [!WARNING]
> Reversible? Backup step here.

## Verify
- Check output …

Decision Record (ADR)

# ADR‑NNN: Title

Date: YYYY‑MM‑DD
Status: Proposed | Accepted | Superseded by ADR‑MMM

## Context
Why this decision matters.

## Decision
What we chose and why.

## Consequences
- Positive
- Negative

## Alternatives
- Option A
- Option B

Publishing Kit

Use this to push the wiki with correct filenames, sidebar/footer, and assets.

File Map (Wiki → Filename)

  • Home → Home.md
  • _Sidebar → _Sidebar.md
  • _Footer → _Footer.md
  • Getting Started → Getting-Started.md
  • Architecture → Architecture.md
  • Hardware → Hardware.md
  • Software Stack → Software-Stack.md
  • Build Guides → Build-Guides.md
  • Governance & Constitution → Governance-and-Constitution.md
  • Memory & Data Model → Memory-and-Data-Model.md
  • Networking & Services → Networking-and-Services.md
  • Remote Access (VNC/SSH) → Remote-Access-VNC-SSH.md
  • Security & Operations → Security-and-Operations.md
  • Action Plan — Oct 31, 2025 → Action-Plan-Oct-31-2025.md
  • Roadmap & Pre‑Releases → Roadmap-and-Pre-Releases.md
  • Contributing → Contributing.md
  • Troubleshooting & FAQ → Troubleshooting-and-FAQ.md
  • Glossary → Glossary.md
  • Page Templates → Page-Templates.md
  • Publishing Kit → Publishing-Kit.md

One‑shot publish

repo="https://github.com/DylanLRPollock/Monkey-Head-Project.wiki.git"
git clone "$repo" MHP-wiki
cp -a ./wiki/* MHP-wiki/
git -C MHP-wiki add .
git -C MHP-wiki commit -m "docs(wiki): publish $(date +%F)"
git -C MHP-wiki push

Remote Access (VNC/SSH)

Preference: TigerVNC on huey‑legacy (GNOME on Xorg).

SSH Tunnel

# local -> remote:1995
ssh -N -L 1995:127.0.0.1:1995 user@huey-legacy

VNC Server (example)

vncserver :1 -localhost -SecurityTypes None -geometry 2560x1440

Warning

Binding VNC to a public interface without auth is dangerous. Keep it localhost and use SSH tunnels.

Roadmap & Pre‑Releases

Phase 1 — Foundations (Pre‑Release #1)

Date: 2024‑04‑11

  • Baseline hardware bring‑up (VIC‑20/C64/C128 references).
  • GenCore seed; basic learning modules.
  • Prototype shell mapping (interfaces, wiring paths).

System Reconfiguration (Pre‑Release #2)

Date: 2025‑05‑25
Theme: Filesystem & docs restructuring; cleaner iteration.
Highlights:

  • Reorganized repos; standardized non‑free firmware policy.
  • Portal (iMac 5K) baseline on GNOME/Xorg.
  • Introduced Huey‑Portable (BR1100FKA) with LTE.
  • Governance axiom: decentralized decision, unified memory.
  • AMD‑first GPU; Vulkan verified for local LLM.

Momentum Toward Oct‑31 (Pre‑Release #3)

Date: 2025‑10‑25

  • Target 6.17.x‑huey kernels; boot logs visible.
  • Python 3.14.x parallel install.
  • Forky staging; containers; allowlist.
  • VNC/SSH codified (1995 via SSH tunnel).
  • Memory schema + provenance tags.

Security & Operations

Keys

  • Rotate the default lab SSH key quarterly; keep personal keys separate.
  • Enforce PermitRootLogin no, PasswordAuthentication no in sshd_config.

Backups

  • Nightly SQLite dump + JSON log rollover to Huey‑Hub.
  • Weekly full image to NAS (retention: 4).

Incident Notes

  • Immutable logs: append‑only; hash chain per day.
  • LIVE USB: tested boot path; minimal net services.

Software Stack

  • OS: Debian 13 (Trixie) → Debian 14 (Forky) adoption begins Oct‑31.
  • Kernel: 6.16.x‑huey → 6.17.x‑huey (perf‑tuned; targeted drivers).
  • AI: Ollama (Mistral‑7B quant), PyGPT‑net agents; Whisper STT; TTS.
  • UI: Minimal green‑on‑black; dual pane (voice vs logs).
  • Memory: SQLite + JSON logs; unified, provenance‑rich.
  • Security: SSH keys, rotatable default lab key; LIVE USB fallback.

Service Map

flowchart LR
  subgraph Userland
    UI["UI<br/>Portal"]
    Agents["Agents<br/>Spark/Zap/Citizens"]
    STT["Whisper STT"]
    TTS["TTS"]
    LLM["Ollama Runtime"]
  end

  Sensors["Sensors/IO"] --> Agents
  UI --> Agents
  Agents --> LLM
  Agents --> STT
  Agents --> TTS
  Agents --> DB[(SQLite + JSON Logs)]
Loading

Folder Conventions

/huey/
  bin/           # launchers + maintenance scripts
  kernels/       # packaged kernels, configs, build logs
  memory/        # sqlite, json logs, vectors (later)
  services/      # systemd units, timers
  ui/            # themes, boot assets, display scripts
  docs/          # project docs (this wiki mirrors)

Troubleshooting & FAQ

APT signature complains about Edge repo

Re‑install key to /etc/apt/keyrings/ and ensure signed-by= is set (see Build-Guides).

GNOME still shows login; want auto‑login

Enable auto‑login in GDM (/etc/gdm3/daemon.conf) and ensure user is in autologin group.

iMac 5K audio missing or wrong default sink

Use the set-default-sink.sh post‑login script and verify PipeWire is active.

Vulkan path not active for Ollama

Check VK_ICD_FILENAMES and OLLAMA_LLM_LIBRARY=vulkan; run with VK_LOADER_DEBUG=all.

Stuck RAID superblocks

Use mdadm --zero-superblock on the exact partitions; rebuild initramfs.

Low laptop brightness

Write max under /sys/class/backlight/*; confirm kernel params don’t override.

© Dylan L. R. Pollock · Code: GPL‑3.0 · Docs/Media: CC‑BY‑SA‑4.0
Last updated: 2025-10-25. See an issue? Open one in the main repo and link the wiki page.

Clone this wiki locally