Skip to content

Architecture

Tim edited this page Aug 15, 2026 · 2 revisions

Architecture

NebulaOS-kernel  ─┐
NebulaOS-klipper ─┼─► NebulaOS-firmware ─► produces artifacts ─► NebulaOS (this repo) ─► publishes releases
NebulaOS-guppyscreen ┘

NebulaOS-firmware is the only repo that pins and cross-verifies all three component repos (manifests/dependencies.conf), and the only one that alone produces a complete, flashable image. This repo consumes its finished, tagged output — it never becomes a second integration tree.

Component Repository Role
Integration / build NebulaOS-firmware Pins every component by exact commit/tag, orchestrates the build, owns build scripts and overlay config.
Kernel NebulaOS-kernel X2000 kernel fork (openke branch) plus 8 accepted build-time variant patches tracked in NebulaOS-firmware.
Klipper NebulaOS-klipper Klipper fork; klippy/extras/ owns PRTouch, Z-compensation, and related NebulaOS-specific functionality.
GUI NebulaOS-guppyscreen GuppyScreen fork for the NebulaOS touch UI.

If you're looking for source code, config, or build scripts, you want one of the other four repos — this one only ever contains release artifacts and the documentation to install or update them.

See also: Repository Map.

Clone this wiki locally