Skip to content

Configure krites from the studio

Open Settings with the ⚙ gear in the top bar of the shoots page for settings that apply to every shoot, or with ⚙ Profile inside a shoot for that shoot's cull thresholds. Changes apply without a restart.

To change Go to
The default cull thresholds every shoot inherits Settings, Image
Object removal: on or off, the backend, the licence Settings, Object removal
Closed-eye and blink detection Settings, Eye detection
The AI reviewer's provider and key Settings, AI review
The running version, and updating Settings, Updates
A /metrics endpoint for watching the studio's memory Settings, Diagnostics
Stopping the studio Settings, Shut down
One shoot's thresholds Inside the shoot, ⚙ Profile

Settings for every shoot

The gear opens Settings · all shoots. A rail down the left groups the settings into Judgement, Models & providers and System, and the panel on the right shows the one you picked. It opens on Image.

  • Image holds the default cull thresholds that new and un-customised shoots inherit: focus, exposure, dedup, blink and face size. This is your house style, so tune it once here.
  • Object removal is behind a licence gate. The inpainting models were trained on data whose licence is unsettled, so the switch stays disabled until you tick I understand and accept the model licence terms. Then turn it on and pick a backend: LaMa for quality or MI-GAN for speed. The Remove-object tool appears without a reload.
  • Eye detection turns the closed-eyes and blink model on.
  • AI review takes a provider (Gemini or Claude) and its API key. The key is stored in your OS keychain, never in the config file or the logs.
  • Updates shows the running version. Its Check for updates button installs a newer release if there is one, in the packaged macOS app; see Update krites. Nothing installs unless you press it.
  • Diagnostics serves a Prometheus /metrics endpoint, and optionally /debug/pprof/, for watching this studio's heap and goroutines. It's off by default and needs the studio's session credential, so it never opens a port to anyone else.
  • Shut down stops the studio server.

Object removal and eye detection each have an optional ONNX Runtime library field. Leave it empty and krites fetches a verified runtime itself; set it only to use a libonnxruntime of your own.

Each leaf saves on its own. After a save the panel re-checks what's available, so a capability you just turned on (object removal, AI review) works straight away. The rail is keyboard-navigable: tab to it and use the arrow keys to move between leaves, and Esc closes the panel.

Some settings are global-only

The AI provider and key, and whether the ONNX models run, are choices for the whole install. They're set only here, never per shoot. Only the cull thresholds can differ between shoots.

One shoot's thresholds

Inside a shoot, ⚙ Profile opens that shoot's Cull profile panel. Every control starts inherited: it shows the global value, disabled, with an override checkbox beside it.

  • Tick the checkbox to override that threshold for this shoot. The slider wakes up and your value is saved as a shoot override.
  • Untick it to drop the override and go back to the global value.

So a sweeping change ("make every shoot a little more forgiving on focus") is one edit to the global default, and every shoot that hasn't overridden focus follows. A shoot you've tuned deliberately keeps its overrides.

Saving re-judges that shoot against the new thresholds and keeps any verdicts you set by hand. Nothing here touches your originals.

Doing it from the CLI instead

The same values are plain config keys, listed in the configuration reference. A global default:

krites config set cull.profile.min_sharpness 60

A per-shoot override is the same key in the shoot's own <shoot>/.krites/config.yaml. The studio is a friendlier front end over the same settings.