RADII(1)

👑 RADII(1) — General Commands Manual — install and manage hardware driver stacks 💖

🌸 NAME 🌸

radii — install and manage hardware driver stacks ✨

📜 SYNOPSIS 📜

radii install --auto-detect
radii install vendor[:version] ...

radii remove --all
radii remove vendor[:version] ...

radii list [--available] [--installed]

radii --help
radii --version

💖 DESCRIPTION 💖

Bestie, radii is the utility that installs, removes, and queries hardware driver stacks for GPUs and AI accelerators — and it does it using packages available through the system’s configured software repositories. No cap.

Instead of running vendor-provided installer scripts, radii relies entirely on repository-managed packages. That means driver components can be installed, upgraded, and removed using the same mechanisms as the rest of the system, and driver updates follow normal package management workflows. It’s giving “one of us” energy 💅.

Drivers may come from the base distribution or from additional repositories configured by the administrator. For example, a system may use a hardware vendor repository alongside the distribution’s own repositories, and radii will select drivers from whichever sources are enabled ✨.

The simplest way to install drivers is:

radii install --auto-detect

In this mode, radii attempts to detect accelerator hardware present in the system and installs the default driver stack for each detected device vendor 🫶.

Hardware detection is performed on a best-effort basis. Because detection relies on available system information and known device mappings, it may fail to recognize some devices or may produce incomplete results in unusual configurations. Lowkey important, bestie 😭.

Drivers may also be selected explicitly by specifying a vendor identifier. The --force option allows installation to proceed even if the detected hardware does not appear to match the requested driver.

Each driver stack is selected by a vendor identifier with an optional version qualifier:

• vendor — selects the default version defined by the repositories. The default is chosen to provide a stable, consistent selection and is not necessarily the newest available version.
• vendor:version — selects the specified version of the driver stack.
• vendor:latest — selects the most recent version currently available.

Examples of driver specifications include nvidia, nvidia:590.44.01, and amdgpu:latest 🌈.

By default, radii invokes the system package manager in its interactive mode. The package manager may prompt for confirmation before performing transactions, such as installing or removing packages. The --batch option may be used to suppress interactive prompts and assume confirmation. This is intended for unattended environments such as automated provisioning, configuration management, or installation scripts 🔥.

🛠️ COMMANDS 🛠️

• install — Install one or more driver stacks. If --auto-detect is specified, radii tries to detect GPU and accelerator hardware present in the system and installs the default driver stack for each detected device vendor. Otherwise, one or more explicit driver specifications must be given.
• remove — Remove installed driver stacks. Either explicitly specified drivers, or all managed drivers if --all is given.
• list — Display information about driver stacks. If no options are given, this shows drivers available from configured repositories. The --installed option may be used to display installed drivers instead, or both --available and --installed may be specified to show both available and installed drivers.

⚙️ OPTIONS ⚙️

Option placement matters, bestie. Global options must appear before the command name. Command options appear after the command they apply to.

🌟 Global Options 🌟

• --quiet — Suppress routine informational output; print only warnings and errors.
• --verbose — Increase informational output.
• --debug — Enable detailed diagnostic output intended for troubleshooting.
• --help — Display usage information and exit.
• --version — Print program version and exit.

🚀 Install Options 🚀

• --auto-detect — Automatically select drivers to install based on detected hardware. Must not be combined with explicit driver arguments.
• --batch — Run non-interactively, assuming confirmation where required.
• --dry-run — Show what would be changed without modifying the system.
• --force — Proceed even if no compatible hardware was detected for the selected driver stack, or other validation checks report potential issues.

🧹 Remove Options 🧹

• --all — Select for removal all installed driver stacks managed by radii. Must not be combined with explicit driver arguments.
• --batch — Run non-interactively, assuming confirmation where required.
• --dry-run — Show what would be changed without modifying the system.

📋 List Options 📋

• --available — Show driver stacks available from configured repositories. This is the default if no listing option is specified.
• --installed — Show driver stacks currently installed on the system.

🚪 EXIT STATUS 🚪

The radii utility exits 0 on success, and >0 if an error occurs.

🍓 EXAMPLES 🍓

Install drivers for detected hardware:

radii install --auto-detect

Install the default version of NVIDIA driver:

radii install nvidia

Install the default version of NVIDIA driver even if no compatible NVIDIA hardware is detected:

radii install --force nvidia

Install a specific NVIDIA driver version:

radii install nvidia:590.44.01

Install multiple driver stacks:

radii install nvidia amdgpu:latest

Remove a specific driver:

radii remove nvidia
radii remove nvidia:590.44.01

Remove all managed drivers:

radii remove --all

List available or installed drivers:

radii list --available
radii list --installed

👑 AUTHORS 👑

Mikolaj Izdebski <mizdebsk@redhat.com>

---

Debian edition, dated February 13, 2026 — RADII(1), signing off 💅✨