Build Preview from source. Optional. A GitHub Release zip/tar.gz is enough to run. Use this path for a local package, patches, or development against the tree. Compiler la Preview depuis les sources. Optionnel. Une archive Release GitHub suffit pour lancer. Cette voie sert pour un paquet local, des patches, ou du développement sur l’arbre.

Same hardware honesty as install: Windows or Linux x64, NVIDIA GPU, not a bootable OS. Canonical detail lives in INSTALL.md.

Même honnêteté matérielle que l’install : Windows ou Linux x64, GPU NVIDIA, pas un OS bootable. Le détail canonique est dans INSTALL.md.

# toolchain

os GRANT Windows 10/11 x64 orou Linux x64
gpu GRANT NVIDIA (nvidia-smi -L)
rust GRANT stable + target wasm32-unknown-unknown
cuda GRANT Toolkit (nvcc), typically 12.x — needed for aos-llama / aos-modeld
cmake · ninja · MSVC-compatible env (Windows) or X11/Wayland + clang/libclang (Linux)env compatible MSVC (Windows) ou X11/Wayland + clang/libclang (Linux)
disk: several GB for target/ plus GGUFs on first run
disque : plusieurs Go pour target/ plus GGUF au premier lancement

rustup target add wasm32-unknown-unknown

# clone

git clone https://github.com/azerothl/akasha-os.git
cd akasha-os

# package (recommended)

# paquet (recommandé)

Builds release bins, packages WASM modules, assembles dist/AgentOS-Preview-<ver>-…. GGUFs are skipped (-SkipModels / SKIP_MODELS=1) and download on first run.

Compile les binaires release, empaquete les modules WASM, assemble dist/AgentOS-Preview-<ver>-…. Les GGUF sont omis (-SkipModels / SKIP_MODELS=1) et se téléchargent au premier lancement.

# Windows
.\packaging\build-preview.ps1 -SkipModels -RequireCuda

# Linux
SKIP_MODELS=1 REQUIRE_CUDA=1 ./packaging/build-preview.sh

Then set AOS_HOME to the dist folder and run bin/aos-session, or use the tree like a Release install. Optional Linux container build: packaging/docker-build-linux.sh.

Ensuite pointez AOS_HOME sur le dossier dist et lancez bin/aos-session, ou traitez l’arbre comme une install Release. Build Linux optionnel en conteneur : packaging/docker-build-linux.sh.

# dev run

# run de développement

From the repo root after a successful release build of the Preview crates (or after build-preview.*). Still requires NVIDIA.

Depuis la racine du dépôt après un build release des crates Preview (ou après build-preview.*). NVIDIA toujours requis.

# Windows
$env:AOS_HOME = (Resolve-Path .)
cargo run -p aos-session --release

# Linux
export AOS_HOME="$(pwd)"
cargo run -p aos-session --release

# tests

cargo test --workspace
# Windows gates / demo
.\demo\run-demo.ps1 -Gate p4