Repository navigation
Releases
Releases · aedmark/FractalOS
FractalOS 1.0.0: The Living Terminal & Distributed Mesh
FractalOS 1.0.0: The Living Terminal & Distributed Mesh
Welcome to the 1.0 era of FractalOS.
FractalOS is a browser-based, Unix-flavoured virtual operating system with a Python kernel running inside WebAssembly (Pyodide / CPython 3.14.2), distributed P2P mesh swarms, and an LLM living in your shell. No build steps, no npm dependencies—just pure web standards, deep architecture, and relentless optimism.
🌟 Highlights in 1.0.0
🌐 Distributed P2P Mesh & Multi-Agent Swarms
- Remote Shell Attachment (
attach,detach,wall,talk): Connect across browser tabs, desktop instances, or remote Raspberry Pi nodes over WebRTC DataChannels and local BroadcastChannel. Collaborative live shell sharing and broadcast messaging without central servers. - Zero-Cloud Peer-to-Peer File Transfer (
mesh-cp): Secure direct binary and text file transfers between connected nodes across the mesh. - Mesh Presence & Telemetry (
peers,netstat --mesh): Visual presence monitor and shell inspector for discovering nodes, measuring latency, and viewing shared capabilities. - Multi-Agent Task Delegation:
samwiseon one node can dispatch sub-tasks to peer agents across the mesh and synthesize distributed results. - Multiplayer TUI Games: Networked games including Connect 4 (
c4) and the NetGame hub (netgame).
🖥️ Terminal Multiplexing & Window Management
- Terminal Split Panes: Divide the terminal into horizontal and vertical split panes (
split-h,split-v,panes,close_pane) with independent shell contexts and keyboard navigation. - TUI Window Manager (
wm,window): Multi-window management for graphical applications (Editor, Paint, Top, Adventure, Chidi, Peers) supporting floating, docking, tiling, minimizing, and maximizing. - Persistent Status Line & Notifications (
status,notify): System status tray showing active background jobs, mesh peer count, audio mute, and desktop notifications. - Clipboard & Drag-and-Drop Bridge (
clip,pbcopy,pbpaste): Seamless host clipboard synchronization and direct file drag-and-drop into the virtual file system.
📦 Package Ecosystem & Security Sandboxing
- Package Tooling (
pkg): Lifecycle management from development to publication (pkg init,pkg validate,pkg pack,pkg publish,pkg search,pkg install,pkg deps,pkg remove). - Cryptographic Verification & Sandboxing (
pkg verify,pkg audit): SHA-256 package signature verification, static AST security audits, permission scoping (root,fs:system,hardware), and execution-time integrity enforcement. - Standard Library Expansion: Pre-packaged community utilities available for one-click installation (
fortune,cowsay,cal,banner).
🥧 Bare-Metal Appliance Mode (Fractal Pi)
- Appliance Provisioning (
extras/build_distro.sh): Automated recipe for Raspberry Pi OS Lite, transforming physical SBCs into dedicated boot-to-shell appliances. - Physical IoT & GPIO Control (
gpio): Control hardware pins, stream sensor inputs, listen for button interrupts, and configure autonomous hardware rules with the AI agent.
🧠 The Living Shell & Kinetic AI (samwise)
- BoneAmanita Autopilot: Full kinetic automation (
samwise --autopilot) with the BoneAmanita driver. - Safety Voltage Budgeting: Automatic risk scoring before execution; destructive commands trigger confirmation or require
--force. - Inner Validation Retry Loop: If an LLM generates invalid flags or syntax, the kernel explains the error back to the model for self-correction.
- Scar Tissue: Ephemeral execution failure context injected into system prompts to prevent repetitive mistakes.
- Stateless Memory Injection: Preserves navigation and execution context across multi-step plans.
- Atomic File Generation (
forge): Dedicated tool for the model to scaffold and write files cleanly without shell escaping issues. - Real Python (
python): CPython 3.14 inside the shell with step budgets, VFS file I/O, and piping.
📦 Release Assets & Checksums
| Archive | Size | SHA256 Checksum |
|---|---|---|
fractalos-1.0.0-web.zip |
9.0 MB | 9e738eb4315fef901d09de69d3cc2da74904faa0eb0de4e265086af3697f10e9 |
fractalos-1.0.0-web.tar.gz |
8.8 MB | 6d662e46687010934d8a1b8bcf6fbcfe9bb872c0fd5d189312bd9912ef821db3 |
fractalos-1.0.0-appliance.tar.gz |
8.8 MB | 4ada76b51fe8c3e818f9149408851c4a632c00007580f96153fdf2e26666a6db |
fractalos-1.0.0-full.tar.gz |
9.0 MB | f120f410cb592a9b480b8cc20186a845b0b875a3fe6bf63422847f988bfa9bc1 |
Quick Start
To run the web bundle immediately:
unzip fractalos-1.0.0-web.zip -d fractalos
cd fractalos && python3 -m http.server 8000
# Open http://localhost:8000 in your browser