Features • Drone Stack • Desktop Shell • Quick Start • Architecture • Packages • Benchmarks • Docs
Minimal footprint for resource-constrained edge devices. |
Native real-time support for robotics and drones. |
Built-in AI inference with LLM, vision, speech & quantum computing. |
Zero telemetry, minimal attack surface. |
| Subsystem | Details |
|---|---|
| MAVLink 2.0 | Full protocol with message signing, UART/UDP transport |
| PX4 Offboard | Position, velocity, attitude command modes |
| Swarm Engine | V/Line/Circle/Grid formations, Raft leader election, DDS+ZMQ |
| Sensor Fusion | 16-state EKF (IMU, GPS, Baro, Mag) |
| Camera | V4L2 abstraction with mmap zero-copy |
| Remote ID | ASTM F3411 compliance |
| WiFi Mesh | 802.11s + BATMAN-adv |
| eBPF QoS | XDP packet classification, MAVLink priority |
| Cellular | 4G/5G modem via QMI/MBIM |
| WireGuard | VPN tunnel management |
| Telemetry | Delta + LZ4 compression |
NeuralOS includes a Qt5 QML desktop environment with glassmorphism design, floating dock taskbar, and 33 built-in applications.
Shell Components:
- Floating dock taskbar with app indicators
- Start menu with search, pinned apps, and app grid
- Notification center with quick toggles and sliders
- Command Palette (Ctrl+K) — Natural language OS control
- Desktop widgets (clock, system stats, weather, media, calendar)
- Window manager with drag, resize, minimize, maximize, close
Applications:
| Category | Apps |
|---|---|
| System | System Monitor, Terminal, File Manager, Settings, Task Manager, Package Manager, Network Center, Ecosystem |
| AI & ML | Neural Studio, AI Agent Hub, AI Assistant, NPU Control Center, AI Bus, AI Memory, Automation Studio, MCP Hub, Knowledge Base |
| Utilities | Calculator, Text Editor, Notes, Calendar, Clock, Weather, Photos |
| Media | Music Player, Video Player, Image Viewer |
| Internet | Web Browser, App Store |
| Defense | Drone Command Center, Defense Monitor |
| Quantum | Quantum Lab (full statevector simulation, 13 gates, 7 presets) |
AI-Inspired Features (inspired by Archon OS, Kuse AI, Fuchsia, WarmWind, Bytebot, Steve OS, CosmOS):
| Feature | Inspiration | Description |
|---|---|---|
| AI Bus Orchestration | CosmOS | Multi-model pipeline coordination and agent management |
| Shared AI Memory | Steve OS | Cross-application contextual AI memory system |
| Command Palette | Bytebot OS | Natural language OS control (Ctrl+K) |
| Automation Studio | WarmWind OS | Record and replay workflow automations |
| MCP Hub | Archon OS | Model Context Protocol server for AI assistant connectivity |
| Knowledge Base | Archon + Kuse AI | RAG-based document indexing and AI-powered search |
| Ecosystem Manager | CosmOS + Fuchsia | Multi-device management and task distribution |
# Build the desktop shell (requires Qt5)
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)
# Run
./src/dashboard/neuraos-dashboard┌────────────────────────────────────────────────────────────────────────┐
│ NEURAOS v5.0.0 │
├────────────────────────────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ LLM │ │ Vision │ │ Speech │ │ Quantum │ │ Desktop │ │
│ │llama.cpp │ │NCNN+OCV │ │whisper │ │ QuEST │ │ Qt5 QML │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ └─────────────┴────────────┴────────────┴────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ NPIE v2.0.0 - NeuraParse Inference Engine (12 backends) │ │
│ │ LiteRT│ONNX│emlearn│Wasm│NCNN│ExecuTorch│OpenVINO│SD│MLC│QuEST│ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ MAVLink 2.0 │ Swarm Engine │ PX4 Offboard │ Sensor Fusion(EKF) │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ WiFi Mesh │ eBPF QoS │ Cellular │ WireGuard │ Remote ID │ OTA │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Secure Boot │ dm-verity │ AES-256-GCM │ NPU/GPU Drivers │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ NPI Init │ cgroups v2 │ OverlayFS │ Watchdog │ BusyBox │ │
│ └──────────────────────────────────────────────────────────────────┘ │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ Linux 6.12 LTS Kernel (PREEMPT_RT) │ │
│ └──────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────┘
| 🤖 AI/ML & LLM | ⚛️ Quantum | 🚁 Robotics | 🌐 Network | 🛡️ System | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
* Disabled by default due to complex dependencies
# Required
Docker >= 20.0
QEMU >= 6.0 (for testing)
# System
RAM: 4GB minimum
Disk: 30GB free space# Clone repository
git clone https://github.com/neuraparse/neuraos.git
cd neuraos
# Build with Docker
docker build -f Dockerfile.x86_64 -t neuraos-builder .
docker run --name neuraos-build neuraos-builder
docker cp neuraos-build:/neuraos/buildroot-2025.08/output/images ./neuraos-images
# Or build native components with CMake
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j$(nproc)# Drone simulation (PX4 SITL)
./scripts/neuraos_sim.sh start
# 5-vehicle swarm simulation
./scripts/neuraos_sim.sh swarm 5make profile-minimal # Core OS only
make profile-drone # Drone flight stack
make profile-robot # Robotics platform
make profile-full # Everything# Quick start (VM + Web Dashboard)
./scripts/start_neuraos.sh x86_64 # or: arm64
# Or launch manually with KVM
qemu-system-x86_64 -enable-kvm -cpu host -m 1024 -smp 2 \
-kernel neuraos-images-x86_64/bzImage \
-drive file=neuraos-images-x86_64/rootfs.ext2,format=raw,if=virtio \
-append "root=/dev/vda rw console=ttyS0" \
-netdev user,id=net0,hostfwd=tcp::2222-:22,hostfwd=tcp::8080-:8080 \
-device virtio-net-pci,netdev=net0 -nographic
# SSH access
ssh -p 2222 root@localhost
# Password: neuraos
# Stop everything
./scripts/stop_neuraos.shVM API: http://localhost:8080
Dashboard: http://localhost:8082
|
GFLOPS
Matrix Ops |
inf/sec
Neural Network |
GB/s
Memory BW |
seconds
Boot Time |
Tested on AMD EPYC 9355P 32-Core • 1GB RAM • KVM
| Platform | Status | Architecture | Notes |
|---|---|---|---|
| ✅ Ready | x86_64 | Production | |
| ✅ Ready | aarch64 | Development | |
| ✅ Ready | ARM64 | Cortex-A72/A76 | |
| ✅ Ready | ARM64 | STM32H7 FMU | |
| ✅ Ready | ARM64 | GPU Accel |
neuraos/
├── 📂 src/
│ ├── 📂 npie/ # NPIE v2.0.0 inference engine
│ │ ├── 📂 api/ # Public C API (LLM, Speech, Quantum)
│ │ └── 📂 core/backends/ # 12 backend implementations (.cpp/.c)
│ ├── 📂 drivers/npu/ # NPU driver (hw + simulated)
│ ├── 📂 drivers/accelerators/# GPU/Vulkan acceleration
│ ├── 📂 mavlink/ # MAVLink 2.0 protocol
│ ├── 📂 offboard/ # PX4 offboard control
│ ├── 📂 swarm/ # Swarm coordination
│ ├── 📂 sensors/ # Sensor drivers + EKF fusion
│ ├── 📂 camera/ # V4L2 camera
│ ├── 📂 network/ # WiFi mesh, eBPF, cellular, VPN, Remote ID
│ ├── 📂 security/ # Secure boot, model encryption
│ ├── 📂 power/ # Power/thermal management
│ ├── 📂 ota/ # RAUC OTA manager
│ ├── 📂 npi/ # NPI init system
│ └── 📂 dashboard/ # Qt5 QML desktop shell (33 apps)
│ ├── 📂 backend/ # 14 C++ backend managers
│ ├── 📂 qml/apps/ # Application QML files
│ ├── 📂 qml/shell/ # Shell components (dock, start menu, etc.)
│ └── 📂 qml/components/ # Reusable UI components
├── 📂 tools/
│ └── 📂 npie_bench/ # Multi-backend benchmark tool
├── 📂 web/
│ ├── 📂 frontend/ # React + Vite + TypeScript
│ └── 📂 backend/ # Node.js + Express API
├── 📂 configs/
│ ├── 📄 neuraos_defconfig # ARM64 (aarch64)
│ ├── 📄 neuraos_x86_64_defconfig
│ ├── 📂 kernel/
│ └── 📂 boards/ # BSP configs (RPi, Jetson, Pixhawk)
├── 📂 package/neuraparse/ # 46 custom Buildroot packages
├── 📂 scripts/
│ ├── 🔧 start_neuraos.sh # Quick start (VM + Dashboard)
│ ├── 🔧 stop_neuraos.sh # Stop all services
│ ├── 🔧 run_qemu_kvm.sh # x86_64 with KVM
│ └── 🔧 run_qemu_headless.sh # ARM64 headless
├── 📂 docs/ # Architecture, API, guides
├── 📂 tests/ # 25 tests (10 unit + 8 integration + 7 driver)
├── 🐳 Dockerfile.x86_64
└── 📄 CMakeLists.txt
| Feature | Status |
|---|---|
| Minimal Attack Surface (<100MB) | ✅ |
| iptables Firewall | ✅ |
| SSH Key Authentication | ✅ |
| No Telemetry | ✅ |
| Offline Operation | ✅ |
| Read-Only Rootfs (optional) | ✅ |
| Model Encryption (AES-256-GCM) | ✅ |
| eBPF Security Policies | ✅ |
| Secure Boot (FIT image) | ✅ |
| dm-verity Root FS | ✅ |
| WireGuard VPN | ✅ |
| RAUC OTA Rollback | ✅ |
| Tool | Description |
|---|---|
npie-bench |
Multi-backend inference benchmark (JSON + human-readable) |
npconvert |
Model format converter |
npprofiler |
Performance profiler |
npsim |
System simulator |
npie-cli |
NPIE command-line interface |
# Build native components & run tests
make npie && make tools && make test
# Benchmark all backends
npie-bench --iterations 500 --json| Document | Description |
|---|---|
| Architecture (2026) | System architecture & technology stack |
| Getting Started | First steps guide |
| API Reference | NPIE v2.0.0 API (Core, LLM, Speech, Quantum) |
| GUI Build Guide | Desktop shell build instructions |
| Security | Security features & best practices |
| Hardware Support | Supported devices |
| Package Guide | Adding custom packages |
We welcome contributions! See CONTRIBUTING.md for guidelines.
# Fork & Clone
git clone https://github.com/YOUR_USERNAME/neuraos.git
# Create branch
git checkout -b feature/amazing-feature
# Commit & Push
git commit -m "Add amazing feature"
git push origin feature/amazing-feature
# Open Pull Request|
|
This project is licensed under the GNU General Public License v2. See LICENSE for details. |
Built with ❤️ by NeuraParse Team • 2026