Get Archaeus

Download

A single bootable ISO. Explore the live environment, then run archaeus-installer to install.

Latest Release
Archaeus 0.1.0
March 2026 Kernel 6.12 Hyprland default x86_64

Full ISO with Hyprland pre-configured, Kitty + zsh + Starship, the ACC installed at /opt/archaeus/acc with auto-launch on first login, themed SDDM login screen, and the complete coffee-shop aesthetic out of the box.

Download ISO ~900 MB
Build from source
Arch Linux requiredarchiso + nodejs

Clone the repo and run ./build.sh. It runs npm install for the ACC, copies it into the airootfs, and calls mkarchiso. Output lands in ./dist/. GitHub Actions builds automatically on every push to main.

View on GitHub
System requirements

What you need

Minimum Min

CPUx86_64, 2 cores
RAM4 GB
Storage20 GB
GPUWayland-capable
BootUEFI or BIOS

Recommended Rec

CPUx86_64, 4+ cores
RAM8 GB+
Storage40 GB SSD
GPUDedicated, Mesa
Display1080p+
Getting started

Install in 4 steps

1
Flash the ISO to USB

Use Balena Etcher or dd on Linux/macOS. 8 GB USB minimum.

sudo dd if=archaeus-0.1.0-x86_64.iso of=/dev/sdX bs=4M status=progress && sync
2
Boot from USB

Disable Secure Boot in BIOS. Set USB as first boot device. You land in a live Hyprland session — credentials are archaeus / archaeus.

3
Run the installer

The TUI installer handles disk partitioning (GPT: EFI + swap + root), locale, timezone, hostname, user creation, GRUB, and copies the ACC to /opt/archaeus/acc.

archaeus-installer
4
First boot — ACC opens automatically

On first login a firstboot flag triggers the ACC in setup mode — pick apps, set accent color and wallpaper. The flag is removed after so it never opens twice.

Read the full install guide →