The Omarchy Robots Manual

Chapter 1

Welcome

Omarchy Robots is an operating system for the computer inside a robot. It is built on NixOS and jetpack-nixos, and it targets NVIDIA Jetson boards first.

The idea is simple. A robot computer should be boring: it boots, you can reach it over SSH, its GPU works, and when an update goes wrong you can go back. You should not have to spend a week setting that up for every new board, and you should be able to say exactly which system an experiment ran on.

So the whole machine is declared in one file, robot.nix. Which board, who may log in, the network, the disk, the GPU stack, the power mode. Everything else is a default you don’t have to think about.

What you get

Where it stands

This is the beginning of the project. Version 0.0.2 (October 2026) adds the first slice of the runtime and a generic pc board to the base system of 0.0.1:

Works today Not yet
The vm board boots, installs onto a blank disk, updates and rolls back, all tested in virtual machines Running on real hardware. Every Jetson target evaluates and builds, and so does pc; none has been booted on a real board or PC
The pc board’s installer installs onto an emulated NVMe drive, in a virtual machine  
The runtime runs its simulated dishwashing scenarios on a laptop and inside an Omarchy Robots VM A real robot, a real camera, a learned policy, anything real-time

The first board booted and validated on real hardware will take version 0.1.0. Until then, treat anything about Jetson or a real PC as prepared, not proven.

How to read this manual

Start with Getting started: it runs the robot as a virtual machine on your laptop in one command. Then read robot.nix to see what you can change. When you have a board on your desk, follow Bring-up on a Jetson.