Installation

Up and running
in minutes.

Install the latest release with a single command, or build from source. You'll need a local LLM server and a model.

★

Quick install (one-liner)

The fastest way to get the latest release binary — no build step required.

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/mnemosyne-systems/orangu/main/install.sh | sh

Windows (Command Prompt):

curl -fsSL https://raw.githubusercontent.com/mnemosyne-systems/orangu/main/install.cmd -o install.cmd && install.cmd

Windows (PowerShell):

Invoke-WebRequest -Uri https://raw.githubusercontent.com/mnemosyne-systems/orangu/main/install.cmd -OutFile install.cmd; .\install.cmd

Installs to ~/.local/bin (Linux/macOS) or %USERPROFILE%\.local\bin (Windows) and warns if it is not on your PATH. Override the location with INSTALL_DIR. Prefer to build from source? Follow the steps below.

01

Install Rust and dependencies

orangu requires Rust and Cargo. On Fedora / RHEL:

dnf install -y git rust cargo

On other distributions, install Rust via rustup.rs. On Windows, use WSL2 with a Linux distribution.

02

Clone and build

git clone https://github.com/mnemosyne-systems/orangu.git
cd orangu
cargo build --release

The release binary will be at target/release/orangu. To install system-wide:

sudo install -Dm755 target/release/orangu /usr/local/bin/orangu
03

Start a local LLM server

orangu works with any OpenAI-compatible server. The recommended options are llama.cpp or Ollama.

# Ollama example
ollama serve
ollama pull qwen2.5-coder:7b

For llama.cpp, pass --jinja --chat-template chatml and point orangu at http://127.0.0.1:8080.

04

Configure and launch

Run the interactive setup wizard. It auto-detects your model and walks through every option:

orangu --init

Or copy the sample config and edit it directly:

cp doc/etc/orangu.conf ~/.config/orangu.conf
orangu --config ~/.config/orangu.conf
05

First commands to try

/help # list all commands
/tools # list model-facing tools
/status # git status
/list_files # browse workspace
/model # switch models
/session # list sessions
Optional tools

Enhance your experience.

delta

Syntax-highlighting pager for /diff. Set it as your Git pager and orangu pipes through it automatically.

bat

A cat replacement with syntax highlighting, used automatically by /show_file when installed.

gh / glab

Required for /pull_request, /comment, and /close on GitHub and GitLab.