A 300-millisecond booting, #![no_std] bare-metal kernel built from scratch in Rust. PolymorphOS is the foundational execution sandbox for the upcoming GenesisOS Universal Agentic Workspace.
The AI industry is currently racing to give autonomous agents (LLMs) "tools"—the ability to execute code, manage files, and interact with operating systems.
Running these agents directly on host machines is extremely dangerous, and standard Linux Docker containers are heavy, slow, and susceptible to escapes. Existing operating systems were built in the 1990s for humans. They were not designed for the speed, structure, or security risks of Artificial General Intelligence.
PolymorphOS is not a Linux distribution. It is a completely custom, sovereign operating system.
It runs on bare-metal silicon (via QEMU or native UEFI hardware). It provides a mathematically verified, Zero-Trust physical "Clean Room" where an external AI can write files, execute logic, and interact with memory without any physical connection to your host machine's file system or network stack.
Note: This v0.5 release represents the Bare-Metal Kernel. The secure Agentic Gateway (GenesisOS) that provides internet routing and OMZTA Cryptography is currently in active development and will be merged in V1.
Standard OS allocators (Linked-Lists/Buddy Systems) use
PolymorphOS features a scratch-built, zero-dependency PCIe NVMe driver. It bypasses traditional file-system bloat to execute Direct Memory Access (DMA) reads/writes directly to the flash controller.
Instead of a legacy 2D window manager, the PolymorphOS UI elements are composed of mathematically rendered 3D Gaussian Splats via the UEFI Graphics Output Protocol (GOP). Windows are organically alpha-blended "clouds" that dynamically coalesce, completely eliminating tearing via a 1-millisecond Double-Buffered compositor.
The kernel features a custom async waker and executor, polling tasks from a lock-free crossbeam_queue and dropping CPU load to 0% (via hlt) when idle.
- IT IS NOT POSIX compliant. You cannot run
apt-getor standard Linux binaries here. - IT IS NOT a daily driver for web browsing. (The kernel intentionally lacks a standard TCP/IP stack to prevent autonomous network exploits).
- IT IS a research-grade "Clean Room."
- IT IS an educational masterclass in modern
#![no_std]Rust hardware orchestration, PCIe enumeration, and interrupt handling.
- Rust Nightly toolchain (
rustup default nightly) - QEMU (
qemu-system-x86_64installed in your PATH)
Clone the repository and run:
cargo run --releasePolymorphOS will compile natively for x86_64-unknown-none, fuse with the OVMF UEFI firmware, and launch QEMU in < 300ms.
Available Local Commands:
Click into the QEMU window to access the Semantic Terminal.
Type HELP to view the currently active bare-metal commands (e.g., SCAN PCI, PING NVME, LIST).
This kernel is designed to act as the "Subconscious Engine" to the GenesisOS "Conscious Gateway." V1 will merge this repository with our Tauri/React Host OS, introducing:
- The TCP Umbilical Cord: Routing commands from the Host to the Kernel via isolated serial pipelines.
- OMZTA Cryptography: Mandating
ed25519cryptographic signatures for all LLM-generated code before bare-metal execution. - Live AI Interaction: Seamlessly executing LLM prompts directly into the bare-metal environment.
- JARVITS Integration: Natively hosting the Pascal-Chimera v9 Cognitive Architecture.
- MDO Compilation: Dynamic runtime compilation of
.mdo(MICT Data Object) logic modules directly to LLVM IR, bypassing Rust entirely for native execution.
License: Boredbrains Open Knowledge Return License v2 (BOKRLv2)
Built by John Edward Reagan III & the Boredbrains Consortium.