{
"summary": "Consolidated architectural specification for MiOS. Hardware, Filesystem, and AI Interface SSOT.",
"logic_type": "blueprint",
"tags": ["MiOS", "Architecture", "Day-0", "SSOT"],
"version": "v0.1.4"
}
MiOS is a container-native workstation engineered for high-performance virtualization and local Generative AI development.
- Transactional Integrity: The system core is cryptographically sealed and managed via
bootc. - Hardware Agnosticism: Universal acceleration for primary GPU vendors (NVIDIA, AMD, Intel).
- Zero-Trust Boundary: Mandatory execution control and kernel-level isolation.
MiOS mirrors the standard Linux FHS within its OCI root.
| Path | Type | Intent |
|---|---|---|
/usr |
Immutable | System Binaries, Libraries, and Static Config. |
/etc |
Persistent | Host-specific overrides. |
/var |
Persistent | System state and User home directories. |
/srv |
Persistent | Sidecar service data (Models, Databases). |
Build-time overlays into /var are architectural violations. All /var state must be declared via tmpfiles.d to ensure atomic, reproducible deployments.
Standardized CDI (Container Device Interface) and ROCm/Arc drivers ensure local AI tools access native hardware performance.
- Hardware Targeting: Primary GPU IDs
10de:2204,10de:1aef.
Tier-1 Hypervisor capabilities (KVM/QEMU) are native to the system core, supporting VFIO-PCI passthrough and shared memory (KVMFR) buffers.
The system architecture exposes a local OpenAI-compatible API surface for autonomous management and user interaction.
| Service | Protocol | Access Point |
|---|---|---|
| Inference | REST | http://localhost:8080/v1 |
| Discovery | MCP | /usr/share/mios/ai/mcp/ |
| Metadata | JSON | /usr/share/mios/ai/v1/ |
Copyright (c) 2026 MiOS. Pure FOSS. Zero Day Ready.