YaguareteOS
Handheld-first KDE distribution on top of Bazzite. A graphics-memory slider for AMD APUs with no BIOS trip, a Portal with 182 install actions, our own apps (Yryvu, Tatu) and FSR4 auto-configuration. Image-based with bootc, atomic updates, signed by our own CI.
Four KDE variants, one pipeline
Pick the variant that matches your hardware. All four are built from the same source tree and signed with the same cosign keypair.
-
yaguarete_os
AMD / Intel desktop
Default variant. Open-source graphics stack, works on most non-NVIDIA hardware.
- Upstream
- bazzite:stable
-
yaguarete_os-nvidia
NVIDIA proprietary
NVIDIA GPU with the proprietary driver. Recommended for gaming on NVIDIA hardware today.
- Upstream
- bazzite-nvidia:stable
-
yaguarete_os-nvidia-open
NVIDIA open kernel module
NVIDIA GPU with the open kernel module (Turing+). Aimed at dev workstations.
- Upstream
- bazzite-nvidia-open:stable
-
yaguarete_os-deck
Handheld (Steam Deck, OneXFly, ROG Ally)
Boots into game mode. Inherited from Bazzite-deck, still on Fedora 43.
- Upstream
- bazzite-deck:stable
Stable releases are signed with cosign. Verify the signature against cosign.pub before installing — instructions in the README.
Bazzite underneath, dev and gaming on top
We inherit the Bazzite gaming stack — Steam, Proton-GE, GameMode, gamescope, MangoHud, recent Mesa — and layer on what we need for daily dev work and for squeezing a handheld. Image-based with bootc: every update is atomic, rollback is one command.
Gaming-ready
Steam, Proton-GE, GameMode, gamescope and MangoHud preconfigured. Recent Mesa/AMD. Handheld profiles (Steam Deck, OneXFly, ROG Ally).
Our own handheld tooling
ujust yaguarete-vram assigns system RAM as graphics memory on AMD APUs without a firmware trip. Plus ujust yaguarete-setup-decky, which installs Decky Loader verifying everything before deleting anything, and yaguarete-fsr4, which detects the GPU and applies the right upgrade.
Atomic and immutable
Image-based on Fedora Atomic with bootc. Every update is a full signed image. Instant rollback if anything breaks.
Dev-friendly
A terminal that arrives configured: kitty with zsh, a Powerlevel10k prompt and FiraCode Nerd Font with ligatures, in one command. Claude Code and Antigravity one click away in the Portal. Toolbox, distrobox and devcontainer first-class. KDE Plasma desktop. Spanish-first defaults, es-AR locale.
Frequently asked questions
No. On top of Bazzite we add: the ujust yaguarete-vram command for splitting RAM into graphics memory on AMD APUs, a yafti Portal with 79 apps and tweaks across 8 sections (188 install/update/uninstall actions, each one logging its output to disk), our own installers for our own apps — Yryvu and Tatu — plus curated recipes for third-party software like Eden, Antigravity, Claude Code or Decky Loader, the ujust yaguarete-fsr4 wrapper that auto-detects the GPU, rescue and per-category install commands (yaguarete-rescue, yaguarete-install-gaming, yaguarete-install-dev), Aurora-style versioning in rpm-ostree status, and our own pipeline signed with cosign.
On an AMD APU the "dedicated VRAM" is carved out by the firmware and changing it means rebooting. The pool the system can move is the GTT: system RAM the GPU maps as graphics memory through the ttm.pages_limit kernel argument. ujust yaguarete-vram exposes it as a percentage (10-90%, with a 6 GiB floor always reserved for the OS): pick a value, reboot, and it persists. Useful for texture-heavy games and for running local language models. No other handheld distribution — Bazzite, SteamOS, ChimeraOS — exposes this.
AMD or Intel GPU on a desktop or laptop → yaguarete_os. NVIDIA with the proprietary driver → yaguarete_os-nvidia. NVIDIA with the open kernel module (Turing+) → yaguarete_os-nvidia-open. Steam Deck, OneXFly or ROG Ally → yaguarete_os-deck (still on Fedora 43, lockstep with Bazzite-deck).
Verify the signature with cosign against our public key, then run sudo bootc switch ghcr.io/lobinuxsoft/<variant>:stable and reboot. The previous deployment stays on disk as a rollback target. Full step-by-step instructions live in the README.
They already are. Each promotion from :testing to :stable produces a GitHub Release plus a permanent archive.org item. The download buttons in the variants section link to the latest published ISO per variant. For bootc users, rebase is direct: sudo bootc switch ghcr.io/lobinuxsoft/<variant>:stable.
Each :stable promotion produces a GitHub Release plus a dated archive.org item under identifier <image>-stable-<fedora>.<YYYYMMDD>. The container registry serves :stable, :testing and :unstable channels for bootc users; the dated tags pin a specific build.