"To Create, Not To Destroy"
PhantomOS is a bare-metal x86_64 operating system built from scratch with a graphical desktop, 25 interactive applications, and an AI governance engine. Data is never deleted — only preserved in immutable layers, like geological strata.
The core principle: destruction is architecturally impossible.
- No Deletion — Data is versioned or hidden, never removed
- Complete History — Every change preserved in geological layers
- AI Governance — The Governor monitors all operations and blocks destructive actions
- Transparency — Full audit trail of every policy decision
| Feature | Description |
|---|---|
| Bare-metal x86_64 kernel | Multiboot2 boot, long mode, 64-bit paging, IDT/PIC/PIT |
| Graphical desktop | 32bpp framebuffer, window manager with draggable windows, sidebar, dock |
| 25 interactive apps | File Browser, Terminal, ArtOS (24-tool paint suite), MusiKey, Notes, PVE Encrypt, and more |
| AI Governor v4 | Behavioral learning, anomaly detection, threat timeline, quarantine system |
| PVE-SBC encryption | AES Rijndael S-box + CBC block chaining + LCG key stream generation |
| GPU HAL | Intel BLT, VirtIO GPU, VMware SVGA II, Bochs VGA, software fallback |
| USB HID stack | UHCI host controller, boot protocol keyboard and mouse |
| VirtIO networking | VirtIO-net PCI driver, ARP/ICMP stack, live ping |
| GeoFS filesystem | Append-only, content-addressed, immutable-layered filesystem |
| ACPI power management | PIIX4 PM, graceful shutdown via SCI/IRQ9 |
| KVM paravirt clock | High-resolution timekeeping in KVM guests |
| Dynamic resolution | 800x600, 1024x768, 1280x720, 1280x1024 |
# Install dependencies (Ubuntu/Debian)
sudo apt install build-essential nasm grub-pc-bin xorriso qemu-system-x86
# Build the ISO
make -f Makefile.boot clean && make -f Makefile.boot iso
# Run in QEMU
make -f Makefile.boot qemuphantomos/
├── Makefile.boot # Build system
├── boot/
│ ├── arch/x86_64/
│ │ ├── boot.S # Multiboot2 entry, long mode setup
│ │ ├── gdt.S # Global Descriptor Table
│ │ └── interrupts.S # ISR/IRQ stubs
│ └── linker.ld # Linker script (kernel at 1MB)
├── freestanding/ # Minimal C library (string, stdio)
├── iso/grub/grub.cfg # GRUB boot menu
├── kernel/
│ ├── kmain.c # Kernel entry point
│ ├── desktop.c # Desktop GUI + all 25 apps
│ ├── desktop_panels.c # Desktop chrome (header, sidebar, dock)
│ ├── wm.c # Window manager
│ ├── governor.c # AI Governor policy engine
│ ├── geofs.c # GeoFS append-only filesystem
│ ├── gpu_hal.c # GPU Hardware Abstraction Layer
│ ├── virtio_net.c # VirtIO networking + ARP/ICMP
│ ├── usb.c / usb_hid.c # USB UHCI + HID drivers
│ ├── acpi.c # ACPI power management
│ ├── pci.c # PCI bus enumeration
│ ├── vmm.c / pmm.c # Virtual + physical memory managers
│ └── ... # 40+ kernel source files
└── phantomos.iso # Bootable ISO (build output)
25 fully implemented apps launched from the desktop sidebar:
| Category | Apps |
|---|---|
| System | System Monitor, Processes, Settings |
| Files | File Browser |
| Security | DNAuth, LifeAuth, BioSense, Governor, Constitution, PVE Encrypt |
| Network | QRNet, Network |
| Media | ArtOS (24-tool paint + AI art + DrawNet), MusiKey, Media Player, PhantomPods |
| Tools | Terminal, Notes, Backup, Desktop Lab, GPU Monitor |
| Apps | Geology Viewer, Users |
See the Wiki for detailed documentation:
- Architecture — Boot sequence, memory layout, kernel subsystems
- GUI Desktop — Window manager, panels, visual polish
- Applications — All 25 apps documented
- AI Governor — Policy enforcement and behavioral learning
- PVE-SBC Encryption — Planck Variable Encryption cipher
- Hardware Drivers — GPU HAL, USB HID, VirtIO, ACPI
- GeoFS Filesystem — Append-only immutable filesystem
- Building and Running — Build instructions and QEMU setup
- Build: GCC, NASM, GRUB (
grub-mkrescue),xorriso - Run: QEMU (
qemu-system-x86_64) with-vga std - RAM: 512MB minimum
Contributions welcome! Please ensure:
- No features that enable data destruction
- Code compiles with
-mno-sse -mno-sse2 -mno-mmx -mno-80387(freestanding kernel) - Follows the "To Create, Not To Destroy" philosophy
CC BY-NC-SA 4.0 (Creative Commons Attribution-NonCommercial-ShareAlike)
- You can share and adapt this project
- You must give credit and indicate changes
- You cannot sell or use commercially
- Derivatives must use the same license
See LICENSE for full terms.
"Nothing is ever truly lost."