Repository navigation
Releases
Releases · pratikgh0se/scouter
Scouter v0.3.0
First public release of Scouter: an MCP server for editing photos in darktable by conversation.
What's in it
- Live edits in the running darktable.
darkroom_sayturns plain phrases ("warmer", "more contrast", "a touch brighter") into fixed parameter steps.darkroom_setsets exact values, anddarkroom_undo_lasttakes the last change back. Each change is one darktable history item you can see and undo yourself. - Every write is confirmed. Scouter reads the XMP sidecar back after each edit. If darktable writes an older history over it, Scouter refuses the write and restores the sidecar.
- Previews.
scout_previewrenders the current edit withdarktable-cliin an isolated config, so the agent can look at the result. - Three layers, one core: a Python API, the
scouterCLI and thescouter-mcpserver, with the same verbs in each. - The original darktable-mcp tools (library browse, ratings, import, styles, camera ingest) still ship as the
darktable-mcpcommand.
Install
pip install 'git+https://github.com/pratikgh0se/scouter@v0.3.0'
scouter setupThen restart darktable, open a photo in the darkroom, and run scouter setup --check. The wheel and sdist are attached below. This fork does not publish to PyPI.
How it was tested
The release gauntlet ran on 2026-11-11 against darktable 5.4.1 on macOS, using scratch copies of real raws (Olympus and Sony):
| Check | Result |
|---|---|
| Cases run | 6191 |
| Crashes | 0 |
| Wrong edits (changed something not asked for) | 0 |
| Original files changed | none |
Known limits
- Some "a touch" phrases make real changes that fall below the test's measurement floor on some frames.
- "warmer" and "cooler" are refused on Sony raws whose color calibration uses a custom illuminant. Scouter will not switch that frame's illuminant mode on its own.
- There is no per-hue color control yet (for example, "blues only").
- Tested on macOS only.
See Honest limits in the README for the full list.
Credits
Scouter is a fork of w1ne/darktable-mcp (MIT). Both copyright lines are kept in LICENSE.