lightcraft/docs
Daniel Voshart cb34bb4842 Faces: Settings > Faces tab and the add-a-model licence dialog
An off-by-default "Recognise faces" toggle and the face model list in Settings,
with a one-drop install: pick a .onnx (Add a model file…) or drop one on the
window. The engine inspects it (recognised by hash, or described from its
shape), a dialog shows its licence, whether commercial use is allowed, what it
was trained on and what LightCraft had to assume, and Install stays disabled
until "I accept" is ticked. "Get…" opens a model's own page in the browser:
LightCraft never fetches a model itself. A file it cannot use says why.

The models folder is shared by the app, the CLI and the MCP server
(`engine::config`, `$LIGHTCRAFT_FACE_MODELS` overrides `<config>/models`), so a
model installed from one is there for the others. A session has none until a host
asks (`with_default_face_models`), which keeps tests hermetic.

Nothing runs a model yet, and the tab says so. Headless tests cover the whole
flow (the dialog, refusing until accepted, installing, a file it cannot use).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-08 21:59:01 -04:00
..
brand Licensing: MIT OR Apache-2.0 files, NOTICE, ArtCraft brand terms 2026-10-04 10:05:02 -04:00
images docs: README (MCP, CLI, export, status, contributing), AGENTS.md (asset enforcement, crash recovery, testing/perf), screenshots re-captured with Inter 2026-09-30 23:52:34 -04:00
showcase M1.4: crash-safe catalog persistence (op log + snapshot) 2026-09-30 23:40:40 -04:00
ai-masks.md Fix #366: the SAM 3 dialog without a download location shows how to install by hand 2026-10-08 20:18:47 +00:00
camera-preview-colour.md Fix #310: CR2 and PEF raws get the starting look fitted to their camera JPEG 2026-10-08 23:13:16 +00:00
contributors.md About: contributor and model credits compiled in (grab bag + table, self-submitted names) (#252) 2026-10-07 21:22:08 -04:00
control-protocol.md Merge PR #351 2026-10-09 00:14:03 +00:00
cr3.md LR-IMP-FORMATS: CR3 C-RAW samples that overshoot the bit depth are clamped 2026-10-08 18:04:01 -04:00
gpu-pipeline.md Merge PR #351 2026-10-09 00:14:03 +00:00
library-shortcuts.md Library: the Photo Grid label footer is translucent; pt-br for "Color label cleared" (#308) 2026-10-08 17:39:23 +00:00
lightroom-catalog-import.md PR218: document optional-data and recovery warnings 2026-10-09 00:17:24 +05:30
localization-de.md M16: add German localization using the existing catalogs 2026-10-08 07:27:32 +02:00
localization-es.md Fix #371: Spanish interface 2026-10-08 20:20:17 +00:00
localization-ja.md LR-BEHAV-LOCALIZE: compile-checked tr_format! for every language catalog 2026-10-07 06:13:44 -04:00
localization-pt-br.md i18n: add Brazilian Portuguese (pt-br) UI translation 2026-10-07 17:03:20 -03:00
localization-ru.md i18n: German and Russian follow-ups (#265, #264) 2026-10-08 18:26:56 +00:00
localization-zh-hans.md LR-BEHAV-LOCALIZE: fill the zh-hans catalog to match zh-hant 2026-10-08 03:08:33 +08:00
localization-zh-hant.md LR-BEHAV-LOCALIZE: Traditional Chinese (Taiwan) UI, stock preset and date localisation 2026-10-07 06:54:26 -04:00
localization.md Fix #371: Spanish interface 2026-10-08 20:20:17 +00:00
mcp.md Issue #182: library.select and id queries reject a photo id that is not in the library 2026-10-08 07:45:41 +00:00
merge.md Merge main (Photo Merge); M1.14b: stack merge results with their sources 2026-10-01 11:00:51 -04:00
parity.md Faces: Settings > Faces tab and the add-a-model licence dialog 2026-10-08 21:59:01 -04:00
raf-compression.md M11.4: harden RAF validation and camera profile fallback 2026-10-08 11:23:55 +02:00
raf-corpus.sha256 M11.4: harden RAF validation and camera profile fallback 2026-10-08 11:23:55 +02:00
releasing.md Fix #319: release builds pin craft-fonts with Noto Sans CJK SC 2026-10-08 17:32:09 +00:00
tint-direction.md Issue #188: Tint sign documented as landed (DNG / Lightroom sign) 2026-10-08 17:29:47 +00:00
vertical-watermarks.md M16: keep grapheme clusters intact in vertical watermarks 2026-10-09 09:02:24 +09:00
web.md Fonts: use craft-fonts as an optional build input; move the Japanese fonts out 2026-10-06 11:35:02 -04:00
whats-new.md Merge PR #416 2026-10-09 00:20:27 +00:00
xmp-interop.md LR-IMP-PROFILES: red / green / blue curves only with the master curve; neutral test values 2026-10-08 16:25:25 -07:00