Building orangu

orangu is a Rust project with a single interactive client binary.

Prerequisites#

• Rust toolchain with cargo
• A running llama.cpp (or compatible) server exposing an OpenAI-compatible API

Install Rust 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.

Build#

Clone the repository and build a debug binary:

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

For an optimized release binary:

cargo build --release

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

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

Test#

cargo test

Example run#

Run without installing using the sample configuration:

cargo run --bin orangu -- --config ./doc/etc/orangu.conf

Manual generation#

The project includes a pandoc-based manual layout under doc/manual/en. To build the HTML and PDF manual:

./doc/build_manual.sh

The script writes output to target/doc/.