Enum Os 

pub enum Os {
    Debian,
    Arch,
    Ubuntu,
    Alpine,
}

A system a profile’s image is built on.

Variants

Debian

Debian 13, from the Node project’s own Debian image. The default, and what a profile file that names no system is.

Arch

Arch Linux, rolling.

Ubuntu

Ubuntu 24.04 LTS.

Alpine

Alpine, on musl rather than glibc; offered, and said to be not recommended.

Implementations

impl Os

pub const ALL: [Self; 4]

Every system, in the order the wizard offers them: the default first, the one said to be not recommended last.

pub fn id(self) -> &'static str

How the system is written in definition files.

pub fn parse(id: &str) -> Option<Self>

The system written as id, if there is one.

pub fn display_name(self) -> &'static str

The system’s own name and release, which is the same in every language.

pub fn recommended(self) -> bool

Whether QCode recommends the system. Alpine is offered for other work and said not to be: of the five harnesses, two do not run on it at all (see Os::refuses).

pub fn image(self) -> &'static str

The name of the system’s base image. Debian’s is the name every image had before there was a choice, so the images already on a machine stay the ones it finds.

pub fn containerfile(self) -> &'static str

The Containerfile the system’s base image is built from, carried inside the binary.

pub fn image_mb(self) -> u64

How large the system’s base image is, in megabytes as podman reports them, so the wizard can say what is being chosen before it is built.

Measured on 2026-09-22 with podman on images built from the Containerfiles as they are now; a change to a Containerfile is a reason to measure again (podman image inspect --format '{{.Size}}', and the live test in live.rs prints it).

pub fn gaps(self) -> &'static [Gap]

What the system’s image does not carry that the Debian image does.

pub fn refuses(self, harness: HarnessKind) -> Option<Refusal>

Why harness is not offered on this system, or None where it is.

Each answer was measured on the system’s own base image, by installing the harness the way its recipe does and running it; the variants of Refusal say what was seen. Where a harness is offered here, it was seen to install and start there: on Alpine, Claude Code and opencode install their own musl builds and Codex’s program is a static musl build; Kimi Code CLI is JavaScript and runs its shell commands without a terminal library, and a command typed into it ran on all four systems (measured 2026-09-23 with 2.1.0), as one typed into Qwen Code did on Debian, Arch and Ubuntu.

pub fn install(self, packages: &[&str]) -> String

The shell command that installs packages from the system’s own repositories and leaves no package lists or downloads behind in the layer. It runs as root.

Arch installs with -Syu: it supports no partial upgrade, so installing from a freshly read package list means upgrading to it.

pub fn python(self) -> &'static [&'static str]

The packages graphify needs from the system: Python 3.10 or later, and pipx to install it with, under each system’s own names.

pub fn python_venv(self) -> &'static [&'static str]

The packages a Python environment needs from the system: the interpreter, and where the system keeps ensurepip out of the interpreter itself, the package that brings pip into it. All four were measured on their own base image on 2026-09-29: Debian and Ubuntu ship python3-venv apart from the interpreter, while Arch’s and Alpine’s python and python3 carry it. pipx is not among them: this is for an environment of our own making, which brings its own pip.

pub fn build_tools(self) -> &'static [&'static str]

The packages building the Quvyta apps needs from the system, under Quvyta development: a C compiler and the tools around it, pkg-config, OpenSSL’s headers, git, ssh, curl, jq, the process tools (ps, pgrep) and bash, under each system’s own names. Arch’s base-devel carries pkg-config (pkgconf) itself.

pub fn chromium(self) -> Option<&'static [&'static str]>

Chromium’s package on this system, or None where the system has none that runs in a container: Ubuntu 24.04’s chromium-browser is only a way to the snap, and snaps do not run inside a container.

pub fn pipx(self, home: &str, package: &str) -> String

How pipx is told to install package outside the home directory, into home, with its commands in /usr/local/bin.

Ubuntu 24.04 packages pipx 1.4.3, which has no --global (it came with 1.5, and 1.4.3 answers unrecognized arguments: --global), so there the location is given the older way, through PIPX_HOME and PIPX_BIN_DIR; it lands in the same places.

Trait Implementations

impl Clone for Os

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Os

impl Debug for Os

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Os

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Os

impl PartialEq for Os

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Os