█████╗ ██╗  ██╗██╗██████╗  █████╗        ██████╗ ███████╗  
██╔══██╗██║ ██╔╝██║██╔══██╗██╔══██╗      ██╔═══██╗██╔════╝  
███████║█████╔╝ ██║██████╔╝███████║█████╗██║   ██║███████╗  
██╔══██║██╔═██╗ ██║██╔══██╗██╔══██║╚════╝██║   ██║╚════██║  
██║  ██║██║  ██╗██║██║  ██║██║  ██║      ╚██████╔╝███████║  
╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝╚═╝  ╚═╝       ╚═════╝ ╚══════╝  

A minimalist retro-cyberpunk gaming console and hacker toolkit powered by ESP32 and WebAssembly

AkiraOS is an open-source gaming console that combines the power of modern embedded systems with the nostalgic appeal of retro gaming. Built on the ESP32-S3 microcontroller and running a custom Zephyr RTOS, it supports WebAssembly applications and doubles as a cybersecurity toolkit for ethical hacking and network analysis.

• 🎯 Retro Gaming: Run classic-style games compiled to WebAssembly
• 🔧 Hacker Toolkit: Built-in cybersecurity tools and CLI access
• 🌐 Network Capable: Wi-Fi and Bluetooth connectivity
• 🔋 Portable: Battery-powered with USB-C charging
• 🎨 Customizable: Cyberpunk-themed UI with multiple skins
• 📱 Modern Architecture: WebAssembly runtime on embedded hardware

AkiraOS runs on multiple platforms with a unified codebase:

• Operating System: Custom Zephyr RTOS
• Runtime: WAMR (WebAssembly Micro Runtime)
• Container Support: OCRE (Open Containers Runtime Environment)
• Development Languages: C/C++/Rust → WebAssembly
• Graphics: Custom pixel-art renderer with CRT effects

• Zephyr SDK: Follow the official installation guide
• Python 3.8+: For build tools
• West Tool: Zephyr's meta-tool for project management
• ESP-IDF Tools: For ESP32 development

Note: Development is recommended on WSL (Windows Subsystem for Linux) or native Linux/macOS.

1. Clone the repository

   mkdir AkiraOS-workspace
   cd AkiraOS-workspace
   git clone https://github.com/ArturR0k3r/AkiraOS.git
   cd AkiraOS/

2. Initialize West workspace

   west init -l .
   west update
   west blobs fetch hal_espressif

3. Open development environment

   code AkiraOS.code-workspace

# Build for all platforms at once
./build_all.sh

This will build:

• ✅ native_sim (simulation/testing)
• ✅ ESP32-S3 (full hardware)
• ✅ ESP32 (full hardware)

cd /path/to/Akira
west build --pristine -b native_sim AkiraOS -d build_native_sim

# Run simulation
./build_native_sim/zephyr/zephyr.exe

cd /path/to/Akira
west build --pristine -b esp32s3_devkitm/esp32s3/procpu AkiraOS -d build_esp32s3
west flash -d build_esp32s3

cd /path/to/Akira
west build --pristine -b esp32_devkitc/esp32/procpu AkiraOS -d build_esp32
west flash -d build_esp32

Press Ctrl+Shift+B to run the configured build task.

# Flash MCUboot bootloader
esptool write-flash 0x1000 build-mcuboot/zephyr/zephyr.bin

# Flash AkiraOS application
esptool write-flash 0x20000 build/zephyr/zephyr.signed.bin

chmod +x flash.sh

# Flash both bootloader and application
./flash.sh

# Flash only bootloader
./flash.sh --bootloader-only

# Flash only application  
./flash.sh --app-only

1. Power on the console
2. Use the D-pad to navigate the menu
3. Select games from the installed WASM applications
4. Use action buttons for gameplay

Coming Soon: Terminal interface with network analysis tools, Wi-Fi scanning, and cybersecurity utilities.

For detailed information on developing WASM applications for AkiraOS, please refer to our comprehensive API Documentation and Game Development Tutorial.

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Test on hardware if possible
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

• Follow Zephyr coding standards
• Use clear, descriptive variable names
• Comment complex logic
• Include unit tests where applicable

• Hardware Assembly Guide
• API Documentation
• Troubleshooting

Hardware kits will be available for purchase later. Stay tuned for updates on availability and pricing.

• Zephyr Project - Powerful embedded RTOS
• OCRE Project - Open container runtime environment
• WebAssembly - Platform-agnostic runtime
• WAMR - WebAssembly micro runtime

This project is licensed under the MIT License - see the LICENSE file for details.

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: [email protected]