---
title: "Installation"
description: "The fastest way to install Nexus OS is with Cargo directly from GitHub: Don't have Rust? Install it first: Pre built binaries are available for Linux and macOS. No Rust toolchain required: Clone the repository and build "
resource: https://www.aiagents.nexus/docs/getting-started/installation
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# 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](https://github.com/leonidas-esquire/nexus-os/releases) page.

Or if built from source:

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