aios-k2chj/aios-k2chj-hw-expert-v3

🧠 Neural OS Hermes — HW Expert v3

The first AI-native bare-metal operating system.

61.453 hardware IDs recognized. 0 errors. No Linux. No POSIX.

---

🔥 What is Neural OS?

Neural OS Hermes is a complete bare-metal operating system written in Rust (no_std), where everything is an Agent or a Skill:

• 🧠 247+ agents — every hardware driver, daemon, and service is an agent
• 🔍 HW Expert v3 — neural network that identifies 61.453 unique PCI/USB/ACPI devices
• 🏗️ Self-healing — detects missing firmware, downloads it via HTTP, loads it hot. No reboot.
• 🎨 3-layer visual — Orb (FFT-reactive) + Hermes CLI overlay + Window Manager
• 🎤 Full audio pipeline — HDA capture + playback, FFT visualization, TTS (Piper VITS)
• 📡 WiFi — Intel AX200/AX210 with real iwlwifi ucode loading
• 🛡️ Zero-trust — SafetyAgent with 4 invariants, fail-closed by default

---

🏗️ Architecture

                    ┌─────────────────────────────┐
                    │      Hermes (Intent Router)   │
                    │  ReAct · Workflow · SDD · MCP │
                    └──────────┬──────────────────┘
                               │
              ┌────────────────┼────────────────┐
              ▼                ▼                ▼
     ┌────────────┐   ┌────────────┐   ┌────────────┐
     │  Cortex    │   │HW Expert v3│   │  Trinity   │
     │  LLM (BitNet)│  │ 61K HWIDs  │   │  MoE Router│
     │  850M params│  │ 1M params  │   │  6 experts │
     └────────────┘   └────────────┘   └────────────┘
              │                │                │
              ▼                ▼                ▼
     ┌─────────────────────────────────────────────┐
     │          247+ Agents (hardware + system)    │
     │  HwDetect · NetAgent · WifiAgent · Display  │
     │  GpuDriver · HDAudio · UvcCam · SelfHeal   │
     │  Cron · Security · Safety · Optimizer · ... │
     └─────────────────────────────────────────────┘
              │                │                │
              ▼                ▼                ▼
     ┌─────────────────────────────────────────────┐
     │     Hardware · Firmware (116 blobs) · ATA   │
     │  NVIDIA GP108 · Intel i915 · Realtek · iwl  │
     │  e1000 · HDA · xHCI · AHCI · NVMe · TPM    │
     └─────────────────────────────────────────────┘

---

🎯 HW Expert v3 — What it does

The HW Expert is a BitNet b1.58 ternary neural network (1M params, 259KB) that runs directly in the kernel (no_std Rust). It identifies hardware devices by their PCI/USB vendor and device IDs:

Capability	Value
Unique VID/DID recognized	61.453
Training data sources	SDIO (171K HWIDs) + pci.ids (23.8K) + usb.ids (23.9K) + kernel PCI tables (494)
Model architecture	128 hidden, 6 layers, 8 heads, FFN 256
Model size	259 KB (fits in L2 cache)
Inference	ADD/SUB only (no FPU), 2-bit packing, 4 weights/byte
Loss	3.55 → 0.389 (converged)

When a new device is plugged in, the kernel:

1. Scans PCI/USB bus → gets VID:DID
2. HW Expert v3 identifies the exact device name
3. SelfHealAgent checks if firmware is needed
4. If missing → downloads from linux-firmware.git via HTTP → loads hot
5. If no driver → LLM generates a skill → SkillObserver registers it

---

📊 Training Data

This model was trained on the largest public hardware ID collection ever assembled:

Dataset	Records	Source
SDIO DriverPacks	171.003 HWIDs	65 Windows DriverPacks, 20K .inf files
pci.ids	23.888 (2.506 vendors, 21.382 devices)	Official PCI SIG list
usb.ids	23.964 (3.427 vendors, 20.537 devices)	Official USB-IF list
Linux kernel	494 PCI entries	Extracted from kernel drivers/
linux-firmware WHENCE	998 entries	Official firmware manifest
AMD microcode	64 patches	Family/Model/Stepping from linux-firmware
Total	~220.620

---

🚀 Getting Started

# Clone the OS
git clone https://github.com/msrovani/neural-os-core.git
cd neural-os-core

# Build (requires Rust nightly)
cargo build --release

# Run in QEMU
python tools/build_image.py
./run-qemu-uefi.ps1

# Or boot on real hardware (x86_64 UEFI)
# Use tools/disk_hw.raw as a USB drive image

---

📦 What's on HuggingFace

Artifact	Description	Link
🧠 neural-os/hw-expert-v3	HW identification model (this)	Model Card →
💾 neural-os/sdio-hwids	171K HWIDs from 65 DriverPacks	Dataset →
💾 neural-os/pci-usb-ids	48K official PCI/USB IDs	Dataset →
💾 neural-os/firmware-metadata	1.2K firmware entries from WHENCE	Dataset →
📡 neural-os/regulatory-db	WiFi regulations for 174 countries	Dataset →

---

📜 License

MIT License — model and training code are open source.
Firmware blobs are MIT license from linux-firmware.git.

---

Neural OS Hermes — "The hardware real não perdoa. O silício obedece."
⭐ GitHub