alfred-linux/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

```bash
# 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

```bash
# 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](LICENSE)

## Links

- **Website:** https://alfredlinux.com
- **Download:** https://alfredlinux.com/download
- **Releases:** https://alfredlinux.com/releases
- **Security:** https://alfredlinux.com/security
- **Company:** https://gositeme.com (GoSiteMe Inc.)