Akasha OS

Preview 0.18.0 is a host app you install and launch — not a bootable image. No clone, no cargo: download the archive, run the install script, then open Akasha OS Preview. La Preview 0.18.0 est une appli hôte que vous installez et lancez — pas une image bootable. Pas de clone, pas de cargo : téléchargez l’archive, lancez le script d’installation, puis ouvrez Akasha OS Preview.

GitHub Releases · latest.json

What you need

Ce qu’il vous faut

  • Windows 10/11 x64, Linux x64, or macOS on Apple Silicon (not Intel Mac)
  • Windows 10/11 x64, Linux x64 ou macOS sur Apple Silicon (pas Mac Intel)
  • NVIDIA GPU with a recent driver recommended on Windows and Linux (nvidia-smi -L)
  • GPU NVIDIA avec pilote récent recommandé sous Windows et Linux (nvidia-smi -L)
  • About 8 GB free disk recommended for a mid-tier GGUF pack (binaries plus first-run models)
  • Environ 8 Go libres recommandés pour un pack GGUF mid (binaires plus modèles au premier lancement)
  • CUDA runtime is included; installing the driver is enough
  • Runtime CUDA inclus ; installer le pilote suffit
  • macOS build is unsigned — expect a Gatekeeper prompt; run ./install.sh after extract (clears quarantine on bin/)
  • Build macOS non signé — attendez-vous à Gatekeeper ; lancez ./install.sh après extraction (lève la quarantaine sur bin/)
  • CPU-only works in Preview 0.18.0 (Settings → Models → Inference; no second zip)
  • CPU seul fonctionne en Preview 0.18.0 (Paramètres → Modèles → Inférence ; pas de second zip)

One command

Une commande

On Windows, this downloads the unified artefact, prints URL and sha256, verifies fail-closed, then overlays into %LOCALAPPDATA%\AgentOS-Preview while keeping var/ and etc/.

Sous Windows, cela télécharge l’artefact unifié, affiche URL et sha256, vérifie fail-closed, puis superpose dans %LOCALAPPDATA%\AgentOS-Preview en conservant var/ et etc/. 

irm https://azerothl.github.io/akasha-os/install.ps1 | iex

On Linux the same idea uses prefix ~/.local/share/agentos-preview:

Sous Linux, même idée avec le préfixe ~/.local/share/agentos-preview : 

curl -fsSL https://azerothl.github.io/akasha-os/install.sh | sh

Windows step by step

Windows pas à pas

  1. Download the unified zip AgentOS-Preview-<ver>-windows-x64.zip (CUDA and CPU backends inside) from GitHub Releases.
  2. Télécharger le zip unifié AgentOS-Preview-<ver>-windows-x64.zip (backends CUDA et CPU inclus) depuis GitHub Releases.
  3. Extract, then run:
  4. Décompresser, puis :
.\install.cmd

Prefer install.cmd — it bypasses a Restricted PowerShell policy. The equivalent is powershell -ExecutionPolicy Bypass -File .\install.ps1. Files land under %LOCALAPPDATA%\AgentOS-Preview; updates keep var/ and etc/. Launch Akasha OS Preview from the Start menu or shortcut.

Préférez install.cmd — il contourne la stratégie PowerShell Restricted. L’équivalent est powershell -ExecutionPolicy Bypass -File .\install.ps1. Les fichiers vont sous %LOCALAPPDATA%\AgentOS-Preview ; les mises à jour conservent var/ et etc/. Lancez Akasha OS Preview depuis le menu Démarrer ou le raccourci.

Quick start without install.cmd still uses the stable data prefix (%LOCALAPPDATA%\AgentOS-Preview):

Démarrage rapide sans install.cmd : le préfixe de données stable est quand même utilisé (%LOCALAPPDATA%\AgentOS-Preview) : 

.\bin\aos-session.exe

macOS step by step

macOS pas à pas

  1. Download AgentOS-Preview-<ver>-macos-arm64.zip (Apple Silicon only; unsigned) from the MAC band above or GitHub Releases.
  2. Télécharger AgentOS-Preview-<ver>-macos-arm64.zip (Apple Silicon uniquement ; non signé) via la bande MAC ci-dessus ou GitHub Releases.
  3. Unzip, then run:
  4. Décompresser, puis :
./install.sh

Prefix: ~/.local/share/agentos-preview (same overlay idea as Linux). Run agentos-preview. Gatekeeper may block unsigned binaries — install.sh clears quarantine on bin/; if needed, right-click Open on aos-session once.

Préfixe : ~/.local/share/agentos-preview (même overlay que Linux). Lancer agentos-preview. Gatekeeper peut bloquer les binaires non signés — install.sh lève la quarantaine sur bin/ ; si besoin, clic droit Ouvrir sur aos-session une fois.

Linux step by step

Linux pas à pas

  1. Download AgentOS-Preview-<ver>-linux-x64.tar.gz (CUDA and CPU backends inside), then extract.
  2. Télécharger AgentOS-Preview-<ver>-linux-x64.tar.gz (backends CUDA et CPU inclus), puis extraire.
  3. ./install.sh
  4. Prefix: ~/.local/share/agentos-preview (non-destructive overlay). Run agentos-preview.
  5. Préfixe : ~/.local/share/agentos-preview (overlay non destructif). Lancer agentos-preview.

What the package contains

Ce que contient le paquet

bin/            daemons + CUDA runtime (CPU zip has no CUDA DLLs)
share/models/   manifest.json (GGUF on first run)
share/modules/  notes.aospkg, tasks.aospkg, ext-rt.aospkg
share/skills/   notes-writer, research, file-author, planner, tasks
share/mcp/      servers.yaml.example
data/models/    catalog.yaml
VERSION         build semver
var/            created at run

First launch

Premier lancement

  1. aos-session checks disk (and NVIDIA if present), then probes VRAM and RAM.
  2. aos-session vérifie le disque (et NVIDIA s’il est présent), puis sonde VRAM et RAM.
  3. Model setup: confirm the auto-best pack for your tier (cpu / low / mid / high), then GGUFs download into share/models/.
  4. Réglage modèles : confirmez le pack auto pour votre palier (cpu / low / mid / high), puis les GGUF descendent dans share/models/.
  5. bus → capkd → auditd → modeld → platformd → agentd
  6. egui UI and a multi-page tutorial. Closing the UI stops the daemons.
  7. UI egui et tutoriel multi-pages. Fermer l’UI arrête les daemons.

Next: first run in the user manual.

Suite : premier lancement dans le manuel.

If something goes wrong

Si quelque chose ne va pas

  • No NVIDIA (Win/Linux) → use Settings → Models → Inference → CPU (slow is OK), or a CPU-oriented archive if you downloaded one separately
  • Pas de NVIDIA (Win/Linux) → Paramètres → Modèles → Inférence → CPU (lent OK), ou une archive orientée CPU si vous en avez téléchargé une à part
  • Gatekeeper blocked macOS launch → run ./install.sh again or right-click Open on bin/aos-session
  • Gatekeeper bloque le lancement macOS → relancer ./install.sh ou clic droit Ouvrir sur bin/aos-session
  • Model download failed → need network to Hugging Face, or copy GGUFs into share/models/
  • Échec téléchargement modèle → réseau vers Hugging Face, ou copier les GGUF dans share/models/
  • Healthcheck failed → check var/run/*.stderr.log (Troubleshooting button)
  • Healthcheck failed → voir var/run/*.stderr.log (bouton Troubleshooting)
  • Bus unreachable → always launch via aos-session
  • Bus unreachable → toujours lancer via aos-session

Build from source

Compiler depuis les sources

Releases are enough to run Preview. Build from source for a local package, patches, or development. Full write-up: docs/build and INSTALL.md.

Les Releases suffisent pour lancer la Preview. Compilez depuis les sources pour un paquet local, des patches ou du développement. Détail : docs/build et INSTALL.md.

  • Stable Rust plus the wasm32-unknown-unknown target
  • Rust stable plus la cible wasm32-unknown-unknown
  • CUDA Toolkit (nvcc) with a working nvidia-smi
  • CUDA Toolkit (nvcc) avec un nvidia-smi qui répond
  • cmake · ninja · clang/libclang (Linux)(Linux) 
# Windows
.\packaging\build-preview.ps1 -SkipModels -RequireCuda

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

# Dev run (repo root)
$env:AOS_HOME = (Resolve-Path .)   # Windows
export AOS_HOME="$(pwd)"           # Linux
cargo run -p aos-session --release
First run