Skip to content

FractalOS 1.0.0: The Living Terminal & Distributed Mesh

Latest

Choose a tag to compare

@aedmark aedmark released this 07 Oct 00:20
· 18 commits to main since this release

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: samwise on 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