|
1 | | -# MiOS ARCHITECTURE — Unified Blueprint (Day 0) |
| 1 | +# MiOS ARCHITECTURE — System Blueprint (Day 0) |
2 | 2 |
|
3 | 3 | ```json:knowledge |
4 | 4 | { |
5 | | - "summary": "Consolidated architectural specification for MiOS. Hardware, Filesystem, and Virtualization SSOT.", |
| 5 | + "summary": "Consolidated architectural specification for MiOS. Hardware, Filesystem, and AI Interface SSOT.", |
6 | 6 | "logic_type": "blueprint", |
7 | 7 | "tags": ["MiOS", "Architecture", "Day-0", "SSOT"], |
8 | | - "version": "1.0.0" |
| 8 | + "version": "v0.1.4" |
9 | 9 | } |
10 | 10 | ``` |
11 | 11 |
|
12 | 12 | ## 🏗️ Core Pillars |
13 | | -MiOS is a container-native, immutable workstation engineered for high-performance virtualization and Generative AI development. |
| 13 | +MiOS is a container-native workstation engineered for high-performance virtualization and local Generative AI development. |
14 | 14 |
|
15 | | -1. **Transactional Immutability**: The userspace is a cryptographically sealed OCI image. |
16 | | -2. **Hardware Agnosticism**: Unified support for Intel, AMD, and NVIDIA silicon. |
17 | | -3. **Zero-Trust Security**: Strict execution whitelisting and kernel-level hardening. |
| 15 | +1. **Transactional Integrity**: The system core is cryptographically sealed and managed via `bootc`. |
| 16 | +2. **Hardware Agnosticism**: Universal acceleration for primary GPU vendors (NVIDIA, AMD, Intel). |
| 17 | +3. **Zero-Trust Boundary**: Mandatory execution control and kernel-level isolation. |
18 | 18 |
|
19 | 19 | --- |
20 | 20 |
|
21 | 21 | ## 💾 Filesystem Hierarchy (FHS 3.0 + bootc) |
22 | | -MiOS follows a rootfs-native repository structure. |
| 22 | +MiOS mirrors the standard Linux FHS within its OCI root. |
23 | 23 |
|
24 | | -| Path | Type | Persistence | Purpose | |
25 | | -| :--- | :--- | :--- | :--- | |
26 | | -| `/usr` | `composefs` | Immutable | Core OS Binaries & Libraries | |
27 | | -| `/etc` | `overlay` | Persistent | Admin Overrides (USR-OVER-ETC Law) | |
28 | | -| `/var` | `ext4/btrfs` | Persistent | User Data & System State | |
29 | | -| `/home` | `symlink` | Persistent | Points to `/var/home` | |
| 24 | +| Path | Type | Intent | |
| 25 | +| :--- | :--- | :--- | |
| 26 | +| `/usr` | Immutable | System Binaries, Libraries, and Static Config. | |
| 27 | +| `/etc` | Persistent | Host-specific overrides. | |
| 28 | +| `/var` | Persistent | System state and User home directories. | |
| 29 | +| `/srv` | Persistent | Sidecar service data (Models, Databases). | |
30 | 30 |
|
31 | | -### ⚖️ Immutable Appliance Laws |
32 | | -- **USR-OVER-ETC**: Never write static config to `/etc` at build time. Use `/usr/lib/<component>.d/`. |
33 | | -- **NO-MKDIR-IN-VAR**: All `/var` directories must be declared via `tmpfiles.d`. Build-time `/var` overlays are strictly forbidden. |
| 31 | +### ⚖️ Immutability Mandate |
| 32 | +Build-time overlays into `/var` are architectural violations. All `/var` state must be declared via `tmpfiles.d` to ensure atomic, reproducible deployments. |
34 | 33 |
|
35 | 34 | --- |
36 | 35 |
|
37 | | -## 🖥️ Hardware & Virtualization |
| 36 | +## 🖥️ Hardware Delegation |
38 | 37 |
|
39 | | -### 🎮 Graphics Acceleration |
40 | | -Native-tier performance via: |
41 | | -- **NVIDIA**: Open-source GSP modules with CDI (Container Device Interface) support. |
42 | | -- **AMD**: KFD/ROCm native support. |
43 | | -- **Intel**: Arc/Xe native support. |
44 | | -- **Hardware Targeting**: Primary GPU IDs `10de:2204,10de:1aef` (RTX 4090). |
| 38 | +### 🎮 Universal Acceleration |
| 39 | +Standardized CDI (Container Device Interface) and ROCm/Arc drivers ensure local AI tools access native hardware performance. |
| 40 | +- **Hardware Targeting**: Primary GPU IDs `10de:2204,10de:1aef`. |
45 | 41 |
|
46 | | -### ⚡ Virtualization Mastery |
47 | | -The system operates as a Tier-1 hypervisor (KVM/QEMU). |
48 | | -- **VFIO-PCI**: Dynamic GPU passthrough for Guest VMs. |
49 | | -- **Looking Glass**: Shared Memory (KVMFR) for low-latency VM display. |
50 | | -- **CPU Pinning**: Core shielding for X3D/Hybrid core isolation. |
| 42 | +### ⚡ Virtualization |
| 43 | +Tier-1 Hypervisor capabilities (KVM/QEMU) are native to the system core, supporting VFIO-PCI passthrough and shared memory (KVMFR) buffers. |
51 | 44 |
|
52 | 45 | --- |
53 | 46 |
|
54 | | -## ⚡ Kernel & Performance |
55 | | -- **Scheduler**: BORE (Burst-Oriented Response Enhancer). |
56 | | -- **Tickrate**: 1000Hz. |
57 | | -- **Memory**: zram (zstd compressed) with le9uo anti-thrashing patches. |
58 | | -- **I/O**: BFQ for slow disks, Kyber for NVMe. |
59 | | - |
60 | | ---- |
| 47 | +## 🤖 AI Interface Surface |
| 48 | +The system architecture exposes a local OpenAI-compatible API surface for autonomous management and user interaction. |
61 | 49 |
|
62 | | -## 📦 Deployment Matrix |
63 | | -| Target | Format | Delivery | |
| 50 | +| Service | Protocol | Access Point | |
64 | 51 | | :--- | :--- | :--- | |
65 | | -| **Bare Metal** | `RAW` | ISO / Disk Flash | |
66 | | -| **Hyper-V** | `VHDX` | Gen2 VM | |
67 | | -| **WSL2** | `Tarball` | WSL Import | |
68 | | -| **OCI** | `Image` | `ghcr.io/kabuki94/mios` | |
| 52 | +| **Inference** | REST | `http://localhost:8080/v1` | |
| 53 | +| **Discovery** | MCP | `/usr/share/mios/ai/mcp/` | |
| 54 | +| **Metadata** | JSON | `/usr/share/mios/ai/v1/` | |
69 | 55 |
|
70 | 56 | --- |
71 | | -*Copyright (c) 2026 MiOS Project. Licensed as personal property.* |
| 57 | +*Copyright (c) 2026 MiOS. Pure FOSS. Zero Day Ready.* |
0 commit comments