A node-graph editor for image & data pipelines — build a graph, wire it up, watch it run.
Darkroom lets you assemble a processing pipeline as a node graph and run it live: wire nodes together and the graph compiles → plans → executes on a background worker, streaming each node's status and results back onto the canvas as it goes. It's a native desktop app built on Palantir, an immediate-mode GUI with a wgpu renderer, over a domain-agnostic graph engine. Its first workload is imaging: general image processing and an astronomical stacking pipeline.
Clone with submodules (git clone --recursive, or git submodule update --init
after a plain clone): Palantir, fits-well and LibRaw build from them. LibRaw's
bindings need libclang — the Xcode tools on macOS, winget install LLVM.LLVM on
Windows, libclang-dev on Linux.
cargo run --profile release-dev # the editor window
cargo run --profile release-dev -- darkroom/sample/sample.darkroom # with the sample project
cargo run --profile release-dev -- --mcp --headless # the editor as an MCP server, no window
cargo run --profile release-dev -- --debug-overlay # the window, with damage and frame stats--mcp alone serves the open window over stdio, so an agent can drive the
editor a person is looking at.
- Node-graph canvas — pan and zoom, rubber-band select, drag between ports to wire nodes, a node palette to spawn from, and a "breaker" scribble that severs wires and deletes nodes in one gesture. Wires gather into ribbons with ties; event subscriptions draw as wires of their own.
- Live async execution — the graph runs on a background tokio worker. Each node shows its status (running, cached, executed, errored, skipped), its elapsed time, and the RAM and VRAM its cached output holds.
- Caching per node — none, RAM, disk or both. The disk cache sits in a folder beside the project, so reproducible results reload across sessions instead of recomputing.
- Panes in docked tabs — the graph, an image viewer, an inspector with a node's live inputs and outputs, and preferences.
- Undo — every edit goes through one undo history, and a held gesture is one entry that Esc takes back whole. Pan and zoom are saved with the project but never undone.
- Project files — RON text in
.darkroom, or the same text zipped in.darkroomz. Paths to files in the project's folder are stored relative to it, so the folder moves as one. - Imaging nodes — image I/O and processing, camera RAW through LibRaw, FITS through fits-well, and the astronomical pipeline: calibration, star detection, registration, stacking, drizzle, and ONNX denoise and star removal.
- An agent harness — the MCP server opens projects, plays input, waits for runs, and reads the editor back as text or as a screenshot.
Darkroom is a Cargo workspace:
| Crate | Role |
|---|---|
darkroom-app (app/) |
The darkroom binary: the window, or with --mcp the editor served over stdio. Default member. |
| darkroom | The editor's library: the document and its undo, the GUI, and the driver that plays input into it. |
| scenarium | The headless graph engine: the authoring model and compile → plan → execute on a tokio worker. |
| lens | The node libraries: application nodes, and adapters over imaginarium and lumos. |
| lumos | The astronomical pipeline: RAW/FITS decode, calibration, star detection, registration, stacking, drizzle. |
| imaginarium | Pixels in both layouts, interleaved and planar, with their codecs and ops, on the CPU and, behind a feature, the GPU. |
| libraw | A safe wrapper over LibRaw, the camera RAW decoder, built statically from its submodule. |
| simd | Every vector instruction of the workspace: the vector types, their ops, and the kernel dispatch. |
| common | The shared base: ids, serialization, cancellation, the 2D grid, and every I/O and thread call. |
| palantir | The immediate-mode GUI — WPF-style two-pass layout, wgpu renderer. Submodule. |
| fits-well | A reader and writer for FITS, astronomy's image format, aiming at the full FITS 4.0 standard. Submodule. |
common and simd are the leaves; scenarium builds the graph engine on
common; darkroom edits a scenarium graph, draws it through palantir, and
takes its nodes from lens, over imaginarium, lumos and fits-well.
Every check is a cargo alias of .cargo/config.toml, run from the workspace
root; the Verification section of AGENTS.md chains them into the gate, which
CI runs too.
AGENTS.md and each crate's own hold the project's decisions.