← Home

LLM-OS

A minimal Linux distro that boots straight into Claude Code. Alpine-based, 88 MB ISO.

Download ISO (88 MB)

How it works

You just need one file: the ISO image (88 MB). Write it to any USB stick and boot from it. The USB stick just needs to be bigger than 88 MB — any standard USB stick works.

  1. Download llm-os.iso
  2. Write it to a USB stick:
    sudo dd if=llm-os.iso of=/dev/sdX bs=4M status=progress
  3. Boot from the USB
  4. First boot automatically sets up everything — installs packages, creates a data partition on remaining USB space, installs Claude Code, and prompts for your API key
  5. All changes persist to the USB across reboots

Quick start (VM)

# Test in QEMU before flashing
qemu-system-x86_64 -cdrom llm-os.iso -m 1G

Alt+F2 for a normal shell if you need it.

Build from source

./build.sh    # needs Docker
./test.sh     # needs QEMU