GitHub

Getting Started

Download LevitateOS and create bootable installation media.

Requirements

  • CPU: x86_64, Intel Haswell (2013) or AMD Zen (2017) or newer
  • RAM: 16GB minimum, 32GB+ recommended for local LLM inference
  • Storage: 512GB NVMe SSD minimum (1TB+ recommended for AI models)
  • GPU: NVIDIA RTX 3060+ (12GB VRAM) for LLM acceleration, or CPU-only with 32GB+ RAM
  • Boot: UEFI required (Secure Boot must be disabled)

Download

Download the latest ISO and verify the checksum:

curl -LO https://releases.levitateos.org/latest/LevitateOS.iso
curl -LO https://releases.levitateos.org/latest/SHA256SUMS
sha256sum -c SHA256SUMS

Creating Bootable Media

USB Drive (Linux/macOS)

# Find your USB device (usually /dev/sdX or /dev/diskX)
lsblk  # Linux
diskutil list  # macOS

# Write the ISO (CAUTION: this erases the drive)
sudo dd if=LevitateOS.iso of=/dev/sdX bs=4M status=progress oflag=sync

USB Drive (Windows)

Use Rufus with DD image mode.

Virtual Machine (QEMU)

# Create a 256GB virtual disk
qemu-img create -f qcow2 disk.qcow2 256G

# Boot the installer
qemu-system-x86_64 \
  -m 8G \
  -smp 4 \
  -enable-kvm \
  -cpu host \
  -bios /usr/share/ovmf/OVMF.fd \
  -cdrom LevitateOS.iso \
  -drive file=disk.qcow2,format=qcow2,if=virtio \
  -boot d

Next Steps

Boot from the ISO to enter the live environment, then follow the Installation Guide to install LevitateOS.