Home

==== Action-Plan-Oct-31-2025.md ====

Action Plan — Oct 31, 2025

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

This checklist is designed to be fed item‑by‑item into your executor (e.g., Codex). IDs are stable.

System

OCT31-01 — Install Linux 6.17.x‑huey; keep previous kernel in GRUB.
OCT31-02 — Pre‑stage Python 3.14.x at /opt/python-3.14 and rebuild ~/huey/.venv.
OCT31-03 — Enable Forky pathfinders (deb822 source in /etc/apt/sources.list.d/forky.sources) but pin to safe priorities.
OCT31-04 — Regenerate initramfs and verify amdgpu early KMS on Portal.
OCT31-05 — Remove splash; keep loglevel=4 vga=normal across nodes.

Memory & Governance

OCT31-10 — Migrate SQLite schema to v2 (events/facts/artifacts + indices).
OCT31-11 — Add signed snapshot routine (daily) to Storage Hub.
OCT31-12 — Implement clause registry file with semantic IDs and hashes.

LLM/Agents

OCT31-20 — Validate Vulkan path for Ollama on Portal/Core; CPU fallback scripted.
OCT31-21 — Pin model manifest under ~/huey/models/manifest.json.
OCT31-22 — Stand up Spark/Zap agent processes with distinct logs.

Ops

OCT31-30 — Enforce SSH keys only; disable password auth.
OCT31-31 — VNC server bind localhost:1995; confirm SSH tunnel helpers.
OCT31-32 — Document RAID/NVMe tests; zero stale MD superblocks if needed.

Publishing

OCT31-40 — Export this wiki; publish ZIP and single‑file MD/TXT (see Publishing-Kit).

==== Architecture.md ====

Architecture

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

HueyOS can run on one box or be federated across several nodes. Memory is unified; governance is clause‑based.

flowchart TB
  A[Huey Sovereign Consciousness]
  B[Binary Brain: Spark (GPU1) & Zap (GPU2)]
  C[Citizen Populace: 256 Agents]
  D[Worker Subsystems: NanoOS / SubOS]
  A --> B --> C --> D

Layers

Sovereign Consciousness — Emergent totality of lawful decision/inaction.
Binary Brain (Spark/Zap) — Creative vs evaluative cores; GPU‑1 and GPU‑2 preferred.
Citizen Populace (256 Agents) — 128+128 civic units with voting/operational roles.
Worker Subsystems — Sensor I/O, motion control, displays; no clause power.

Topology

Huey‑Portal: iMac 5K (2017), Debian; universal display and light hub.
Huey Core: BD795I‑SE ITX, Ryzen 9 7945HX; main compute.
Huey‑Legacy: Robot shell (paused; head/IO testing optional).
Huey‑Hub: MBP 2017 (Win10) for quick transfers and tooling.
Storage Hub: Supermicro X9QRI‑F+; archival/cold storage and lab data.

Principles

Offline‑first. APIs are opt‑in and scoped.
Decentralized governance, unified memory.
Reproducible builds (kernel, packages, configs).
Human‑readable logs as a first‑class artifact.

==== Build-Guides.md ====

Build Guides

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Keep your exact configs in repo under huey/ (see Publishing-Kit).

==== Contributing.md ====

Contributing

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Ground Rules

PRs should be reproducible: scripts/configs included; no manual steps only.
Keep diffs small; link to issue; include test notes.
Docs follow this wiki style; Mermaid nodes must use single‑line labels (no \n or <br/>).

Commit Prefixes

core: kernel/boot/OS
stack: LLM/agents/packages
gov: governance/constitution
mem: schema/logging
docs: wiki/readme/diagrams
ops: security/networking/remote

==== Getting-Started.md ====

Getting Started

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

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

Install Debian (UEFI, amd64). Choose GNOME on Xorg for iMac 5K targets.
Enable non‑free firmware (Realtek, Intel, etc.).
Create user dlrp (or your own) and enable sudo.
Network: prefer bonded Ethernet → Wi‑Fi fallback.
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

First Boot Hygiene

# journald size & persistence
sudo mkdir -p /var/log/journal
sudo install -d -m 0755 /etc/systemd/journald.conf.d
sudo tee /etc/systemd/journald.conf.d/size.conf >/dev/null <<'EOF'
[Journal]
SystemMaxUse=500M
RuntimeMaxUse=200M
EOF

# prefer no splash + visible boot logs
sudo sed -i 's/^\(GRUB_CMDLINE_LINUX_DEFAULT=\)".*"/\1"loglevel=4 vga=normal"/' /etc/default/grub
sudo update-grub

# default suspend: deep (if available)
echo 'MEM_SLEEP_DEFAULT=deep' | sudo tee /etc/default/mem-sleep >/dev/null
sudo install -m0755 /dev/stdin /usr/local/sbin/set-mem-sleep.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
want=$(awk -F= '/^MEM_SLEEP_DEFAULT=/{print $2}' /etc/default/mem-sleep 2>/dev/null || echo deep)
avail=$(cat /sys/power/mem_sleep 2>/dev/null || echo "")
case "$avail" in *"$want"*) echo "$want" | tee /sys/power/mem_sleep >/dev/null || true ;; esac
EOF

Create the Huey workspace

mkdir -p ~/huey/{bin,logs,config,models,mem,media}
mkdir -p ~/huey/mem/{sqlite,logs}

Minimal ~/huey/config/huey.toml:

[identity]
name = "HueyOS"
motto = "Decentralize governance, unify memory"

[memory]
sqlite_path = "/home/$USER/huey/mem/sqlite/huey.db"
log_dir     = "/home/$USER/huey/mem/logs"

[stack]
ollama = { enabled = true }
pygpt  = { enabled = true, venv = "/home/$USER/huey/.venv" }
tts    = { enabled = false }
stt    = { enabled = false }

[governance]
model = "CloudPyramid"

Python userland (PyGPT‑net baseline)

python3 -m venv ~/huey/.venv
source ~/huey/.venv/bin/activate
python -m pip install --upgrade pip wheel
# Optional voice I/O
pip install "pyaudio==0.2.14" "openai-whisper"
deactivate

Local LLMs (Ollama/CPU/AMD)

The reference is offline‑first. Install your LLM runtime (e.g. Ollama) and place models under ~/huey/models. For AMD GPUs, prefer a Vulkan backend; CPU is acceptable for first run.

First run launcher

cat > ~/huey/bin/huey-run <<'EOF'
#!/usr/bin/env bash
set -e
ROOT="$HOME/huey"
CONF="$ROOT/config/huey.toml"
VENV="$ROOT/.venv"
LOG="$ROOT/logs/huey-$(date +%F-%H%M%S).log"
echo "Starting HueyOS…"
if [ -d "$VENV" ]; then source "$VENV/bin/activate"; fi
export HUEY_CONFIG="$CONF"
python -c 'print("HueyOS bootstrap OK")' | tee -a "$LOG"
EOF
chmod +x ~/huey/bin/huey-run
~/huey/bin/huey-run

Optional: Desktop polish (GNOME on Xorg)

Auto‑login (trusted single‑user): enable for your user in gdm3.
Backlight: choose the /sys/class/backlight/* device with largest max and set to 100% at boot via one‑shot service.
Audio: set PCH analog speaker as default sink via a small pactl script at login.

See Troubleshooting-and-FAQ for crib notes.

==== Glossary.md ====

Glossary

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Cloud Pyramid — Governance model with clause/quorum‑based decisions.
Portal — iMac 5K node used as universal display/light hub.
Huey‑Key — Live USB environment for quick recovery and field ops.
Spark/Zap — Bicameral core agents (creative/evaluative).
Citizen Populace — 256 agents with narrow roles and voting rights.

==== Governance-and-Constitution.md ====

Governance & Constitution

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

HueyOS is governed (not merely programmed) by clauses and quorum. Decision‑making is decentralized; memory is unified.

Core Tenets

Decentralize decision‑making, unify memory.
Clause‑based actions, logged and auditable.
Quorum voting within the 256‑agent populace.

Agents

Spark (GPU1) — creative/exploratory.
Zap (GPU2) — evaluative/discipline.
Citizens (256) — operational/voting units with narrow scopes.

Memory Law

Append‑only event logs and SQLite databases form the canonical record.
Worker subsystems consume memory; do not alter constitutional clauses.

==== Hardware.md ====

Hardware

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Reference Nodes

Huey‑Portal — iMac 5K (2017), 48 GB RAM; AMD Radeon RX 470; Debian 13 (Xorg).
Huey Core — Minisforum BD795I‑SE ITX, Ryzen 9 7945HX; DDR5‑5200; Optane M10 NVMe modules.
Huey‑Legacy — Robotic shell (WowWee 9001B head), basic IO (mics, speakers, LEDs).
Huey‑Hub — MacBook Pro 2017 (Win10) for quick file hops/tooling.
Storage Hub — Supermicro X9QRI‑F+ (quad Xeon E5‑4627 v2); RAID experiments; 10 Gb NIC.

Display & Input

Portal drives 5K panel on Xorg; prefer amdgpu early KMS and visible boot logs.
Remote: TigerVNC (see Remote-Access-VNC-SSH), SSH keys only.

Networking

ASUS GT‑AC5300; bonded Ethernet preferred, Wi‑Fi fallback. Default GW 192.168.44.1.
LTE backup on Huey‑Portable (ASUS BR1100FKA).

Naming

Common hostnames: HUEY-PORTAL, HUEY-CORE, HUEY-LEGACY, HUEY-HUB (adjust to taste).

==== Home.md ====

Home

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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

flowchart TD
  U[User]
  Portal[Huey-Portal (iMac 5K Debian)]
  Core[Huey Core (BD795I-SE ITX)]
  Legacy[Huey-Legacy (Robot Shell)]
  Hub[Huey-Hub (MBP 2017 Win10)]
  Storage[Storage Hub (Supermicro X9QRI-F+)]
  U --> Portal --> Core
  Core --> Legacy
  Core --> Hub
  Core --> Storage

==== Huey-Key-Live-USB.md ====

Huey‑Key Live USB (RAM‑boot with persistence)

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Goals

RAM‑bootable Debian with custom 6.16/6.17 kernel.
Persistent SquashFS layer; unified SSH keys; safe recovery path.

Partition Plan (example, GPT)

1 GiB — UEFI boot
4 GiB — swap
16 GiB — root (ext4)
100 GiB — persistence
optional — encrypted secrets

Notes

Name the fallback live environment LIVE and expose via GRUB menu.
Keep SSH keys preloaded for quick access to lab nodes.

==== Kernel-617x-Guide.md ====

Kernel 6.17.x — build/install

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Install toolchain

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

Speedrun (build from current config)

cd ~/kernels && mkdir -p src && cd src
# example sources; replace with your mirror of 6.17.x
wget -O linux.tar.xz https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.17.5.tar.xz
tar -xf linux.tar.xz && cd linux-6.17.5

# start from current running config
cp -v /boot/config-$(uname -r) .config
yes "" | make olddefconfig

# recommended toggles (ZSTD, EFI, AMDGPU early KMS); adjust via menuconfig if needed
make -j"$(nproc)" bindeb-pkg
sudo dpkg -i ../linux-image-6.17*.deb ../linux-headers-6.17*.deb

sudo update-grub
sudo reboot

Portal (iMac 5K) hints

Prefer Xorg; enable amdgpu early KMS in GRUB: amdgpu.dc=1 amdgpu.aspm=1 if stable.
Keep loglevel=4 vga=normal for visible boot diagnostics.
PipeWire/Pulse PCH analog sink selection may need a small login script (see Troubleshooting-and-FAQ).

==== LLM-Setup-AMD-or-CPU.md ====

Local LLMs on AMD or CPU

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

AMD Vulkan path (example for Ollama)

# pick RADV explicitly (confirm path exists)
export VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/radeon_icd.x86_64.json
export OLLAMA_LLM_LIBRARY=vulkan
export VK_LOADER_DEBUG=all   # debug only
# ./ollama serve

CPU fallback

Works out of the box; slower but fine for first‑run tests.

Models

Place under ~/huey/models. Keep a short manifest in git for reproducibility.

==== Memory-and-Data-Model.md ====

Memory & Data Model

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Unified Memory

Default: SQLite at ~/huey/mem/sqlite/huey.db.
Logs: ~/huey/mem/logs (append‑only).

Schema (minimal seed)

events(id, ts, actor, action, payload_json)
facts(key, value, ts)
artifacts(id, path, sha256, ts)

Practices

Prefer structured logs with timestamps and actor IDs.
Periodic compaction and signed snapshots for integrity.

==== Networking-and-Services.md ====

Networking & Services

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Network Strategy

Bonded Ethernet when possible; Wi‑Fi fallback; LTE for Huey‑Portable.
Default GW often 192.168.44.1 in the lab reference.

Services

SSH (keys only), TigerVNC on localhost with SSH tunnel.
Ollama/PyGPT kept on private subnets; expose via SSH tunnels when needed.

Storage

Supermicro X9QRI‑F+ slated as archival/cold storage hub; NVMe experiments ongoing.

==== Page-Templates.md ====

Page Templates

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

New Build Guide

# <Title>

**Goal:** <what this builds>  
**Inputs:** <hardware/OS>  
**Outputs:** <artifacts/logs>

## Steps
1. <step>
2. <step>

## Validation
- <checks>

## Rollback
- <how to revert>

==== Portal-Polish-iMac5K.md ====

Portal polish — iMac 5K

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Xorg over Wayland

On iMac 5K targets, Xorg avoids early bring‑up quirks.

Backlight one‑shot service (pattern)

Choose the /sys/class/backlight/* with the highest max_brightness and set to that on boot.

Audio: prefer PCH analog sink

Small pactl login script to set default sink and unmute at ~60% volume.

Boot verbosity

Remove splash; loglevel=4 helps early GPU/audio triage.

==== Publishing-Kit.md ====

Publishing Kit

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Exporting

This wiki can be exported as a ZIP or merged into a single MD/TXT for sharing.
Avoid Mermaid labels with linebreaks to pass GitHub’s parser.

Files in this export

wiki/*.md — per‑page files for GitHub Wiki.
HueyOS-wiki-2025-10-25.zip — packaged archive.
HueyOS-wiki-2025-10-25_SINGLE.md — single concatenated Markdown.
HueyOS-wiki-2025-10-25_SINGLE.txt — plain text.

==== Remote-Access-VNC-SSH.md ====

Remote Access (VNC/SSH)

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

VNC Workflow (reference)

Use TigerVNC on huey-legacy (GNOME on Xorg).
VNC server bound to localhost:1995, security types None (tunnel only).
Access via SSH tunnel; custom vnc helper on huey-portal.
Default resolution 2560x1440. Avoid unsupported DeferUpdate; prefer RawKeyboard.
SSH keys for passwordless access.

SSH Tunnels (pattern)

ssh -N -L 1995:127.0.0.1:1995 dlrp@HUEY-LEGACY
# Then point your VNC client to 127.0.0.1:1995

==== Roadmap-and-Pre-Releases.md ====

Roadmap & Pre‑Releases

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Pre‑Release #1 — April 11, 2024 (Foundations)

Legacy hardware bring‑up as first‑class references (VIC‑20, C64, C128).
GenCore seed with basic learning modules; multi‑environment compatibility.
Prototype shell mapping and wiring paths.

System Reconfiguration — May 25, 2025

File/document restructuring; hardware and software updates for efficiency.

Pre‑Release #2 — 2025-10-25

Theme: Consolidation and runway to the Oct 31, 2025 update.

Highlights

Portal Upgrade: iMac 5K on Debian 13 (Xorg) as universal display; visible boot diagnostics, amdgpu early KMS.
Core Compute: BD795I‑SE ITX with DDR5‑5200 and Optane M10 modules stabilized as Huey Core.
Governance & Memory: Formalized Cloud Pyramid layers; unified memory via SQLite + append‑only logs.
LLM Runtime: Offline‑first stance; AMD Vulkan path validated; CPU fallback documented.
Ops Hardening: SSH keys enforced, VNC via localhost+SSH tunnel; journald caps; splash disabled.
Forky Pathfinders: Staged plan for Debian 14 components alongside kernel 6.17.x and Python 3.14.

Next

Execute Action-Plan-Oct-31-2025; publish post‑update Pre‑Release #3 notes.

Future

Storage Hub NVMe + RAID experiments; live USB “Huey‑Key”; expanded agent civic roles.

==== Security-and-Operations.md ====

Security & Operations

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Accounts

Create a non‑root user; grant sudo; disable root SSH login after setup.

Keys

SSH keys everywhere; no passwords over the network. Keep a default lab key in a secrets store and rotate later.

Updates

Track Debian security; adopt Forky staging selectively after Oct 31.
Pin kernels explicitly and keep last‑known‑good in GRUB.

Backups

Signed snapshots of ~/huey/mem and /etc. Cold archive on Storage Hub.

==== Software-Stack.md ====

Software Stack

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

OS

Debian 13 (Trixie) baseline; adopting Debian 14 (Forky) selectively from Oct 31, 2025.

Kernels

Current: 6.16.x‑huey (custom).
Incoming: 6.17.x‑huey (ZSTD, EFI/EFI_STUB, AMDGPU early KMS; debug off).

Userland

Ollama (local LLMs; prefer Vulkan on AMD).
PyGPT‑net (orchestrator; venv at ~/huey/.venv).
Audio: PipeWire/Pulse; PCH analog sink scripts for iMac 5K.
Display: GNOME on Xorg (Portal).
Browser: Edge Dev or minimal (qutebrowser) for light tasks.

See Build-Guides for kernel, LLM, and Huey‑Key Live USB guides.

==== Troubleshooting-and-FAQ.md ====

Troubleshooting & FAQ

Note

You’re reading the Monkey‑Head‑Project (HueyOS) wiki. 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.

Desktop won’t auto‑login

Verify gdm3 auto‑login and ensure Xorg session on iMac 5K.

Backlight stuck low

Choose the /sys/class/backlight/* with the largest max_brightness and set via one‑shot service.

Audio prefers wrong sink

Use pactl to pick the PCH analog sink and set default on login; unmute and set to ~60%.

GPU acceleration missing (AMD)

Xorg preferred; enable amdgpu early KMS; confirm Vulkan ICD path and try RADV.

Boot too quiet

Remove splash; keep loglevel=4 vga=normal in GRUB.

Mermaid parse errors

On GitHub, do not put \n or <br/> in node labels. Keep labels single‑line.

==== _Footer.md ====

© 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.

==== _Sidebar.md ====