Akasha OS
Language: English | Français
Site: azerothl.github.io/akasha-os
Agent-native operating system — capability-based security, semantic IPC,
first-class GPU, offline-first. Preview builds run on Windows/Linux (NVIDIA or
CPU) and macOS Apple Silicon; a seL4 bare-metal track is separate.
This is not a bootable OS image yet. Preview 0.19.0 is an installable host
app for testers (Windows/Linux/Mac Apple Silicon; NVIDIA optional on Win/Linux
via CPU path in the same zip).
Why Akasha OS
Most agent stacks are apps on top of a general-purpose OS. Akasha OS treats
agents, models, tools, and memory as first-class system services with
explicit capabilities, audit, and policy — so autonomy stays bounded and
observable.
Preview features
Full catalogue: docs/FEATURES.md.
| Area | What you get |
|---|
| Chat / Sessions | Parallel persisted conversations; search, pin, reversible archive; slash commands (/image, /speak); per-session model |
| Memory | Long-term facts; memory-first agent bootstrap |
| Notes | Human + agent-authored notes (WASM); resyncs on boot after an update |
| Tasks | Dual-surface tasks module + Tasks tab |
| Agents | Goal loop, skills, tools, MCP (client + optional aos-mcpd), External CLIs / Advanced Runtime (Codex / Claude / Grok), scheduler; transparency timeline and Markdown trace export |
| Caps | List / revoke capabilities in UI |
| Models | Hardware-aware packs (incl. CPU); retryable failed loads; prefix-cache/speculation controls; optional image/TTS packs; live TTFT / tok/s / VRAM metrics |
| Canvas | Layered vector drawing, grid and snapping, PNG/SVG/JSON export, agent scene checks and global geometry validation |
| Illustration Studio | Experimental DeclUI module (local catalogue): SceneGraph edit → stub/CPU beauty; wgpu ≠ Blender; see FEATURES §4c; product spec Draft v0.1 in module |
| Providers | OpenAI-compat cloud + loopback (Ollama / vLLM / LM Studio); keys in the vault |
| Network | Opt-in search + web.browse (no JS) + fetch; JS/SPA pages via optional browser MCP |
| Settings | Language, theme, density, trust, routing, gpu/cpu/auto, agent defaults, search engine |
| Feedback | Local report + GitHub issue on this repo |
| Troubleshoot | In-app diagnostics; GitHub report when findings exist |
| Updates | Non-destructive overlays from GitHub Releases |
Requirements
- Windows 10/11 x64 or Linux x64 or macOS on Apple Silicon (not Intel Mac)
- NVIDIA GPU + recent driver (
nvidia-smi -L) on Windows/Linux or CPU-only mode (slower)
- ~8 GB free disk recommended (binaries + GGUF models downloaded on first run)
macOS builds are unsigned — expect Gatekeeper after download; run install.sh.
Quick start
- Download the latest zip/tar.gz from
GitHub Releases.
- Run
install.ps1 (Windows) or ./install.sh (Linux).
- Launch Akasha OS Preview — first run downloads models if needed, then
opens the in-app tutorial.
See docs/INSTALL.md and docs/FIRST-RUN.md.
Cohort protocol: docs/TESTER.md (15-minute path first).
Hangout: docs/community.md.
Developers / build from source
Full steps (toolchain, package scripts, AOS_HOME): INSTALL.md — Build from source.
cargo test --workspace
.\packaging\build-preview.ps1 -SkipModels -RequireCuda
$env:AOS_HOME = (Resolve-Path .)
cargo run -p aos-session --release
.\demo\run-demo.ps1 -Gate p4
Documentation
French mirrors live under docs/fr/.
Licence
Host OS — dual licensing.
- AGPL-3.0-only (
LICENSE) — free use/modify/distribute,
including commercially, if you honor AGPL (source available, including
network use). Keep NOTICE and credit
Akasha OS.
- Commercial license (
LICENSE-COMMERCIAL.md) —
proprietary forks / closed SaaS. Attribution + royalty. Contact:
[email protected].
Guest extensions (ADR 0006) — no commercial
grant:
The Akasha OS trademark is reserved.
Status
Preview cohort (PC) is in progress. Gate: 3 Windows + 1 Linux + 1 macOS
Apple Silicon on the 15-minute path. Full tables:
docs/STATUS.md.
