Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

From crates.io

The easiest way to install Orrery is via Cargo:

cargo install orrery-cli

This installs the orrery binary to your Cargo bin directory (typically ~/.cargo/bin/).

From source

Clone the repository and build in release mode:

git clone https://github.com/orreryworks/orrery.git
cd orrery
cargo install --path crates/orrery-cli

Verify installation

orrery --version

You should see the version number printed. If the command is not found, ensure ~/.cargo/bin is in your PATH.

Requirements

  • Rust 1.88 or later (for building from source)

Optional dependencies

The CLI binary ships with the graphviz layout engine enabled by default. To use it, install Graphviz so that the dot command is available on your PATH:

PlatformCommand
macOSbrew install graphviz
Ubuntu/Debiansudo apt install graphviz
Fedorasudo dnf install graphviz
Windowswinget install graphviz

If you don’t need the Graphviz engine, you can install without it:

cargo install orrery-cli --no-default-features

This builds a binary that uses only the basic and sugiyama layout engines with no external dependencies.