← All docs

Getting Started

PurmaLinux is an AI-first Linux distribution built on Fedora. This guide walks you through the first install.

Requirements

  • Any x86_64 machine
  • 4 GB RAM minimum, 16 GB recommended if you want to run local LLMs
  • NVIDIA GPU optional but recommended for gaming and AI workloads
  • Fedora 42 (primary target) or any of the supported distros

1. Clone the repo

git clone https://github.com/fastslack/PurmaLinux.git
cd PurmaLinux

2. Pick your profiles

PurmaLinux ships with 8 curated workstation profiles:

  • ai — Ollama, LM Studio, Open WebUI, ComfyUI, JupyterLab
  • dev — Neovim, VSCodium, lazygit, DBeaver, Bruno, Podman
  • gaming — Steam, Lutris, Heroic, MangoHud, GameMode
  • design — Krita, GIMP, Inkscape, Scribus, FontForge
  • video — Kdenlive, OBS Studio, DaVinci Resolve, Audacity
  • audio — Ardour, LMMS, Carla, Vital, qpwgraph
  • photo — darktable, RawTherapee, digiKam, Hugin
  • secure — Signal, KeePassXC, Tor Browser, VeraCrypt

3. Run the installer

./installer/install.sh --profile=ai,dev,gaming

The installer detects your distro, enables the required repos (RPM Fusion, Flathub, our PurmaLinux repo), and installs everything in one pass.

4. Reboot and enjoy

sudo reboot

On first login, you’ll see the Aurora-themed Hyprland desktop. Press Alt+A to open the Chat module and say hi to your local LLM.