AkiraOS Documentation
High-Performance WebAssembly OS for Embedded Systems
Production-ready embedded OS combining Zephyr RTOS with WebAssembly sandboxed execution.
Quick Start
New to AkiraOS? Get up and running in under 15 minutes:
- Installation Guide — Set up development environment
- Build Your First App — Hello World in WASM
- SDK Best Practices — Write better apps from day one
- Troubleshooting — Common issues and fixes
Already familiar? Jump to:
- Architecture Documentation — System design deep dive
- API Reference — Complete WASM API docs
- SDK API Reference — Full Akira SDK function reference
- Platform Guides — Board-specific setup
What is AkiraOS?
AkiraOS is a production-ready embedded operating system that enables secure, dynamic application execution on resource-constrained devices through WebAssembly.
Core Features
- Zero-Trust Execution — WASM sandboxing + capability-based access control
- Real-Time Performance — Zephyr RTOS with <60 ns native call overhead
- AOT Compilation — Optional native code execution (10–50x faster than interpreter)
- OTA Updates — MCUboot secure firmware updates with rollback
- Multi-Platform — ESP32, nRF54L15, STM32, native simulation
- Modular Connectivity — WiFi, Bluetooth, USB
- Rich SDK — Display, sensors, RF, storage, networking, BLE, HID, and system APIs
Key Metrics
| Metric | Value |
|---|---|
| Native call overhead | ~60 ns |
| WASM load time (100 KB app) | ~80 ms |
| Max concurrent apps | 2 (configurable per board) |
| Memory per app | 64–256 KB configurable |
| Boot time | ~500 ms (ESP32-S3) |
Learn more about the architecture
Documentation Sections
Getting Started
Install, build, and deploy your first WASM application.
- Installation Guide — Environment setup
- First App Tutorial — Hello World
- Troubleshooting — Common issues
Architecture
Deep dive into system design, components, and data flows.
- System Overview — Complete architecture
- Connectivity Layer — Network protocols
- AkiraRuntime — WASM execution environment
- AOT Compilation — Native code compilation for 10–50x performance
- Security Model — Capability system
- Data Flow — End-to-end diagrams
API Reference
Complete native API documentation for WASM applications.
- API Overview — Quick reference
- Native API — All functions
- Manifest Format — App metadata
- Error Codes — Return values
SDK Developer Guide
Complete Akira SDK documentation for WASM app development.
- SDK API Reference — All SDK functions with examples
- Best Practices — Patterns for efficient, maintainable code
- Building WASM Apps — Complete build workflow
- Debugging — Debug techniques and tools
- OTA Updates — Over-the-air firmware deployment
- SDK Troubleshooting — Debug common app issues
Platform Guides
Board-specific setup and configuration.
- Platform Overview — Supported platforms
- ESP32-S3 Guide — Primary platform
- ESP32-C3 Guide — RISC-V variant
- Native Simulation — Host PC testing
- nRF54L15 Guide — Nordic BLE
- STM32 Guide — Experimental
Hardware
Custom hardware designs and schematics.
- AkiraConsole & AkiraMicro — Custom hardware platforms
Resources
Additional learning materials and references.
- FAQ — Frequently asked questions
- Glossary — Technical terms
- Performance — Benchmarks
Use Cases
IoT Gateways
- Sensor data collection and cloud forwarding
- OTA updates for remote devices
Wearables and Handhelds
- Gaming consoles (AkiraConsole)
- Fitness trackers (AkiraMicro)
Industrial Automation
- Programmable logic with WASM
- Secure remote updates
- Multi-protocol connectivity
Education and Research
- WASM on embedded systems
- RTOS development
- Security sandboxing research
System Requirements
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 256 KB | 512 KB + PSRAM |
| Flash | 2 MB | 8 MB+ |
| CPU | ARM Cortex-M33 | Dual-core @ 240 MHz |
| Connectivity | None | WiFi + BLE |
Contributing
AkiraOS is open source and welcomes contributions.
- Report Issues: GitHub Issues
- Discussions: GitHub Discussions
License
AkiraOS is licensed under the GNU General Public License v3.0.
Third-party components: Zephyr RTOS, WASM Micro Runtime (WAMR), MCUboot, ESP-IDF.
External Links
- Zephyr Project: docs.zephyrproject.org
- WAMR: github.com/bytecodealliance/wasm-micro-runtime
- WebAssembly: webassembly.org