Repository navigation
immich-steward 0.2.0
Pre-release
Pre-release
GeoCLIP suggests locations by the look of a photo, in a worker on the server or on another
computer; a photo card where the map always stays in view.
Added
- Workers: separate processes that run heavy location modules for the core, on the same server
or on another computer (they only connect to the core, which gives them the photos). Shared
tokenSTEWARD_WORKER_TOKEN, job queue with priorities, retries and leases. - GeoCLIP location module: suggests up to five areas by the look of a photo. Runs
automatically on photos without a location while a worker is connected
(STEWARD_AUTO_MODULES; accounts take turns, newest photos first), or on request with Run
in the photo card. - Optional
workerservice in Docker Compose (CPU), with a model cache, a memory limit and an
option to wait while the machine is busy (STEWARD_WORKER_MAX_LOAD). - GeoCLIP suggestions are shown by confidence: below 25 % they are hidden as noise, 25–50 % are
folded as weak ("probably only the region is right"), from 75 % they are marked as confident
(STEWARD_GEOCLIP_*). The thresholds come from a check on photos with known locations. - Confidence of every suggestion as a percentage next to its bar.
- Gallery filter "Confident GeoCLIP guess": photos without a location that GeoCLIP places
confidently, ready to be checked and saved one after another. - Gallery markers: a pin on a white disc for photos with a location (instead of a hard to see
green dot), an orange crosshair for confident GeoCLIP guesses. - Workers and the progress of module runs on the Library page.
Changed
- Photo card in three columns that fill the window: the map always stays in view, the panel to
pick the location and the suggestions scroll on their own, the photo and its details are on
the right. On medium screens the two side columns become tabs; on small screens everything is
stacked. Compact suggestion rows; hovering a row highlights its marker and the other way round.
A click on a suggestion row shows it on the map without picking it; hovering a neighbor's
thumbnail shows it enlarged. - The main actions (Save, Skip, Not applicable) are at the top of the panel and bigger; Save turns
green as soon as a point is picked, so that it is not forgotten.
Upgrading from 0.1.0: git pull and docker compose up -d --build. To use GeoCLIP, set STEWARD_WORKER_TOKEN in .env and start with docker compose --profile worker up -d --build — see docs/install.md. The project is under active development.