faceless-photolib

Introduction

A headless, color-managed, GPU image-editing engine.

faceless-photolib is a headless, color-managed, GPU-accelerated, non-destructive image-editing engine. It is not a Photoshop/PSD clone — it is the engine you build an editor (or a server-side render farm, or an agent tool) on top of.

The same document renders to the same pixels (within float tolerance) on the web (WebGPU), React Native (WebGPU via Dawn), and the server (Node WebGPU via Dawn). At its core is an ordered layer stack compiled to a float ACEScg render graph of GPU passes.

What's inside

  • An ordered layer stack: image, adjustment, 3D-LUT, color-transform, fill, text, and groups.
  • Every Photoshop blend mode (27, per W3C Compositing Level 1) over premultiplied alpha.
  • A color-managed pipeline: transfer functions, primaries, Bradford adaptation, ACEScg working space.
  • 3D LUTs (.cube / .3dl / ACES .clf) with tetrahedral interpolation, and DCTL/CLF color transforms.
  • Headless crop / rotate / straighten controllers replicating Photoshop and Lightroom.
  • A CPU reference backend (the golden renderer) and a WebGPU backend sharing one WGSL codebase.

Install

pnpm add @faceless-photolib/engine-api

Browse the packages for API references generated from source, or open the editor to try it in your browser.

On this page