commander/alfred-linux
1
0
Fork 0
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity
Alfred Linux - AI-Native OS
2 Commits 2 Branches 0 Tags 110 KiB
Shell 100%
300e1877f1
Go to file
commander 300e1877f1 docs: comprehensive README with build history and verification
2026-04-07 15:44:38 -04:00
README.md docs: comprehensive README with build history and verification 2026-04-07 15:44:38 -04:00

README.md

Alfred Linux

The AI-Native Operating System

Alfred Linux is a complete operating system where AI IS the interface. Voice-first, post-quantum encrypted, token-incentivized, everything-connected. Not a distro with a chatbot — the AI IS the OS.

Build Status

Build Version Status ISO Size
RC1 2.0 ✅ Built 2.4 GB
RC2 2.0 ✅ Built 2.4 GB
RC3 2.0 ✅ Built & Bootable 2.5 GB
RC4 3.0 ✅ Built 2.4 GB
RC5 3.0 ✅ Built 2.4 GB
RC6 4.0 ✅ Built 2.4 GB
RC7 4.0 ✅ Built 2.3 GB
RC8 4.0 ✅ Built & Current 2.4 GB

10 ISOs built. 8 release candidates shipped.

What's Included

  • Kernel 6.1.0 LTS (Debian stable, hardened)
  • Alfred IDE — code-server 4.114.0 with Commander extension
  • Alfred Voice — Kokoro TTS engine (offline, no cloud)
  • Alfred Search — Meilisearch instant search (offline)
  • Calamares Installer — graphical install to disk
  • Post-quantum cryptography — Kyber-1024 (ML-KEM-1024) ready
  • ClamAV antivirus, UFW firewall, AppArmor MAC
  • Full offline capability — no cloud dependency

Building

# Requires: Debian 12+ host, live-build, root/sudo
cd scripts/
sudo ./build-unified.sh

The build script is self-contained — it generates the complete ISO from a Debian base using live-build with custom hooks.

Build Hooks (executed in order)

  1. Branding — Plymouth splash, wallpaper, GRUB theme, login screen
  2. Browser — Installs Alfred Browser (Chromium fork)
  3. IDE — Installs code-server + Alfred Commander extension
  4. Voice — Installs Kokoro TTS engine + voice models
  5. Search — Installs Meilisearch + prebuilt indexes
  6. Installer — Configures Calamares graphical installer

Critical Boot Fix (discovered RC2→RC3)

Two kernel-naming hooks are required:

  • 9999-fix-kernel-names.hook.chroot — creates generic kernel names in /boot/
  • 9999-fix-kernel-names.hook.binary — creates generic names in binary/live/ after lb copies versioned files

Without both, the ISO boots to a kernel panic. See scripts/build-unified.sh for details.

Build Server

ISOs are built on a dedicated EU build server:

  • 8 cores, 32 GB RAM
  • Debian Bookworm host
  • Isolated build environment (clean chroot each run)

Verification

# Download ISO
wget https://alfredlinux.com/downloads/alfred-linux-4.0-rc8-amd64.iso

# Verify SHA-256
sha256sum alfred-linux-4.0-rc8-amd64.iso
# Expected: 647e56fd433da2322f5d5ed3e0122d19fec85604f65dee9a129940f06f877c02

# Boot in QEMU
qemu-system-x86_64 -m 4096 -cdrom alfred-linux-4.0-rc8-amd64.iso -boot d

License

AGPL-3.0 — see LICENSE

Links