# NumericalOS

> A Linux userspace whose init is a graph export. No unit files: every
> supervisable thing, boot ordering constraint, health rule, and
> remediation path is a node in an M/G/S/MGS graph quartet.

Status: bootstrap logic tested; boot unverified. The authors have never
booted it, on hardware or in emulation. See /docs/status.

## Build it yourself

These skills drive YOUR agent to build targets on YOUR machine. This site
does not generate images and does not host them.

- [numericalos-build-initramfs](https://numericalos.com/skills/numericalos-build-initramfs/SKILL.md): Build a NumericalOS initramfs (cpio.gz) whose /init is the graph-driven bootstrap. Use when numericalos-target-classifier routed here, or when the user asks for a NumericalOS initramfs, initrd, or the userspace half of bootable media. Assembles a static busybox, the boot chain, and a verified numos.state into a cpio archive that a kernel can hand control to.
- [numericalos-build-iso](https://numericalos.com/skills/numericalos-build-iso/SKILL.md): Build NumericalOS bootable media - a hybrid ISO that boots from optical or USB, pairing a kernel with the graph-driven initramfs. Use when numericalos-target-classifier routed here, or when the user asks for a NumericalOS ISO, USB stick, bootable image, or bare-metal media. Builds the initramfs first, then wraps kernel plus initramfs in a BIOS/UEFI-bootable image.
- [numericalos-build-oci](https://numericalos.com/skills/numericalos-build-oci/SKILL.md): Build a NumericalOS OCI container image runnable by Docker, Podman, containerd, or nerdctl. Use when numericalos-target-classifier routed here, or when the user asks for a NumericalOS container/Docker/Podman image. Covers the OCI, rootless-Podman, and LXC/system-container differences honestly rather than flattening them, and states plainly what a container can and cannot prove about a boot.
- [numericalos-target-classifier](https://numericalos.com/skills/numericalos-target-classifier/SKILL.md): Use FIRST, before any NumericalOS build skill, to decide which target the user's machine can actually produce - OCI container image, initramfs, hybrid ISO/USB, or nothing buildable here. Triggers - "build NumericalOS", "make a NumericalOS image", "boot NumericalOS", "which NumericalOS target", "NumericalOS on my machine", or any request to produce NumericalOS bootable media or a container image. Probes the real toolchain rather than assuming, and routes to exactly one build skill.
- [numericalos-verify-boot](https://numericalos.com/skills/numericalos-verify-boot/SKILL.md): Boot a NumericalOS artifact under QEMU and report what actually happened. Use after any NumericalOS build skill, or when the user asks to verify, test, smoke-test, or prove a NumericalOS image boots. This is the ONLY skill in the family permitted to make a boot claim, and only about the exact artifact and architecture it observed. Closes the verification gate the NumericalOS repository itself cannot close.

## Protocol

- [AGENTS.md](https://numericalos.com/AGENTS.md): multi-agent build protocol and honesty contract
- [index.json](https://numericalos.com/index.json): machine-readable index
- [skills.zip](https://numericalos.com/skills.zip): the whole bundle

## Source

    git clone https://numericalos.com/numericalos.git

Served as static files over dumb-HTTP. No forge, no account, no
server-side code. Verify what you got before you run it.