robo-nix

Appearance

robo-nixNative robot-learning runtime for uv projects.

`robo shell` prepares the Nix layer without taking over Python packaging.

Get Started
Developer

Start from an existing uv project

Pin Python with `uv python pin`, run `robo shell`, then use `uv sync` inside the prepared runtime.

Get native libraries into Python

Add components such as `native-build`, `linux-headers`, `desktop-gl`, `qt6`, or `cuda-toolkit` in `robo.nix`.

Fix missing shared libraries

When an import fails on `libassimp.so` or another native library, use `robo search` to find Nix package candidates.

robot-learning
$ uv python pin 3.11
$ robo shell
generated
  ✓ wrote    ./flake.nix
  ✓ wrote    ./robo.nix
inferred
  ✓ native-build   pyproject.toml dependency `evdev`
  ✓ linux-headers  pyproject.toml dependency `evdev`
launching zsh
[robo] $

Workflow ​

Install once, then enter the runtime from each project:

bash
curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/ausbxuse/robo-nix/master/scripts/install.sh | sh
uv python pin <version>
robo shell
uv sync

robo shell prepares the native runtime first, then leaves Python package sync to the normal uv workflow inside that shell.