oz0-node toolchain fetch
For: Operators and developers looking up a command.
Download, at build time, everything a node installs before its runtime starts: the uv release this binary pins, the CPython build that uv installs for each runtime bundle's Python version, every third-party package of the bundles' requirements.txt as wheels, and the Node.js release this binary pins for plugins' npm packages, for each platform. Every file is checked against its SHA-256 (pinned in this binary, in the Python release's SHA256SUMS, or in requirements.txt) and listed in toolchain.json.
An edge serves the folder from its dist directory (dist/toolchain/), and nodes then install from the edge alone. Runs again add to what is there; downloads are kept in --cache.
Usage
oz0-node toolchain fetch [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--cache | string | the user cache directory | where downloads are kept between runs |
--dir | folder | dist/toolchain | the toolchain folder: toolchain/ in the dist directory the edge serves |
--index | string | https://pypi.org/simple | the package index (PEP 691) wheels come from |
--mlx-lm | bool | mirror the mlx-lm the node installs for its mlx model servers, from the lock built into it (with --platform darwin/arm64) | |
--no-node | bool | leave Node.js out (nodes then download it from nodejs.org for npm plugins, unless offline) | |
--platform | platform | a node platform to mirror for: linux/amd64, linux/arm64, linux/amd64-musl, linux/arm64-musl, darwin/amd64, darwin/arm64, windows/amd64 (repeatable; default this machine's) | |
--plugin | folder | a Python plugin's folder whose locked packages (every group) and build backend to mirror, for offline nodes; one without a uv.lock is locked first (repeatable) | |
--python | version | another Python version to mirror (repeatable) | |
--requirements | file | a requirements file, pinned by version and hash, whose packages to mirror too (repeatable) | |
--runtime-bundle | dir | a runtime bundle dir whose Python and packages to mirror (repeatable) |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--data-dir | string | ~/.local/share/orchestrator-zero-node | where the node keeps its identity, uv, Python, runtimes and state |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0-node commands and the global flags.