FractalOS Documentation

Architecture

FractalOS is structured in six layers, from the kernel at the bottom to native Fractyne applications at the top. Each layer only depends on the one below it, which is what lets pieces of the system evolve independently.

1. Kernel

The core foundation responsible for system control and hardware communication. Everything else in FractalOS ultimately sits on top of this layer.

2. Core Services

Background systems that manage applications, resources, and operating functions — the layer that turns raw kernel capability into something the rest of the system can build on.

3. Drivers, Memory & Filesystem

Talks to hardware and storage directly, and manages how memory is allocated across the system.

4. User Environment

The desktop interface, window management, and system-level tools that create the day-to-day FractalOS experience.

5. Applications

The native app layer — system tools and, eventually, third-party software — that most users interact with directly.

6. Fractyne Integration

The native language layer. Fractyne code runs directly against the system, without a translation layer in between, which is what makes it the intended language for building on FractalOS.

FractalOS is in active development at version 0.6. This architecture describes the current design direction, not a finished, audited system.

APIs

There is no stable, public API yet. What follows is an early preview of the shape system APIs are expected to take, built around the same fractalos.* module pattern shown on the Fractyne side.

integration.fy

import fractalos.systemlet battery = system.batteryLevel()echo "Battery at " + battery + "%"

The intent is a set of system modules — fractalos.system, and others to follow as they're built — that Fractyne programs import directly, with no separate SDK layer.

Treat every API name on this page as subject to change. Nothing here is frozen until FractalOS reaches a stable release.

Development Information

Versioning

FractalOS uses 0.x version numbers throughout pre-release development. 1.0 is reserved for the first stable release — see the roadmap for what that milestone includes.

Current status

Version 0.6 is focused on core architecture, interface systems, and internal services. Development is active and ongoing.

Following along

Source code isn't public yet. The best way to follow progress right now is the FractalOS roadmap or to reach out directly.