Installation

Quick Install (Recommended)

The fastest way to install Nexus OS is with Cargo directly from GitHub:

bash

cargo install --git https://github.com/leonidas-esquire/nexus-os.git

Don't have Rust? Install it first:

bash

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Download Binary

Pre-built binaries are available for Linux and macOS. No Rust toolchain required:

bash

# macOS (Apple Silicon)
curl -fsSL https://github.com/leonidas-esquire/nexus-os/releases/latest/download/naos-v0.3.1-darwin-aarch64 -o naos
chmod +x naos
sudo mv naos /usr/local/bin/

# macOS (Intel)
curl -fsSL https://github.com/leonidas-esquire/nexus-os/releases/latest/download/naos-v0.3.1-darwin-x86_64 -o naos
chmod +x naos
sudo mv naos /usr/local/bin/

# Linux (x86_64)
curl -fsSL https://github.com/leonidas-esquire/nexus-os/releases/latest/download/naos-v0.3.1-linux-x86_64 -o naos
chmod +x naos
sudo mv naos /usr/local/bin/

From Source

Clone the repository and build with Cargo for full control:

bash

git clone https://github.com/leonidas-esquire/nexus-os.git
cd nexus-os
cargo build --release
sudo cp target/release/naos /usr/local/bin/

Verify Installation

Confirm the installation succeeded:

bash

naos --version

Requirements

Requirement	Details
Operating System	macOS, Linux, or Windows (WSL)
Architecture	x86_64 (amd64) or aarch64 (arm64)
Disk Space	~50MB
Runtime Dependencies	None
Build Dependencies	Rust 1.75+ (only for cargo install / source builds)

Updating

To update to the latest version:

bash

cargo install --git https://github.com/leonidas-esquire/nexus-os.git --force

Or download the latest binary from the Releases page.

Or if built from source:

bash

cd nexus-os
git pull origin main
cargo build --release

Quickstart