Static copy

Copied from docs/en/getting-started/installation.md in https://github.com/poppy-team/aipo-lang (MIT). Pinned to revision ce47c4e070404fc41722ccd8e2b7b808b99062a8, blob 68e0ff256dcc079b2ab0ea611d7157cd90c35201. The source repository remains canonical; this copy is refreshed through a sync pull request, not live.

Installation & Setup

The Aipo compiler and toolchain are distributed as an open unified workspace in Rust.

---

Prerequisites

To build and run Aipo locally:

• Rust 1.85+ (MSRV verified with Rust 2024 edition support)
• Cargo (included with the standard Rust toolchain)
• Node.js 18+ (optional, only needed when executing output emitted by aipo-js)

To install Rust on Linux, macOS, or WSL:

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

---

Building from Source

Clone the Aipo repository and compile the command-line interface binary (aipo-cli):

# 1. Clone the repository
git clone https://github.com/poppy-team/aipo-lang.git
cd aipo-lang

# 2. Build in release mode with maximum optimization
cargo build --release -p aipo-cli

# 3. The executable binary will be available at:
./target/release/aipo --version

Adding to your PATH

To make the aipo command accessible globally:

# On Linux / macOS
cp ./target/release/aipo ~/.local/bin/

# Verify installation
aipo --help

---

Verifying Installation

Verify that all subsystems operate properly:

aipo check --help
aipo run --help
aipo disasm --help

To validate the workspace integrity and execute the full suite of 500+ automated tests:

cargo test --workspace