Cimmich

Community Preview 18 Exact Immich 3.1.0 Local-first · Source ↗

The private memory layer for Immich

Your photo library stores images. Cimmich remembers what they mean.

Connect the people, places and stories you remember, then use those connections to find the photos that matter.

A separate app you self-host with Docker beside Immich. Your connections live in Cimmich's database. It never writes changes back to Immich or your original photos.

  • People
  • Pets
  • Places
  • Things
  • Events
  • Documents
Cimmich Home showing the connected Cedar House memory library.

Cedar House demo · Fictional people and stories

Matching that improves
Your confirmations give the next search better evidence.
Connect the archive
Follow the people, places and events that connect your photos.
Take the knowledge with you
Keep your decisions and linked documents when you move your library.

The story is already in your archive

Bring the photos, people and details back together.

Select a screenshot for a closer look.

  1. 01 / Bring the story together

    A weekend becomes more than a folder.

    Bluewater Weekend brings its photos, journey, people and documents together in one place to return to.

    The Bluewater Weekend event page showing its photos, journey, connected people and documents.
  2. 02 / Keep the source nearby

    Let a document explain the moment it belongs to.

    Nora's invitation stays linked to both Nora and her birthday, where it can be found from either.

    Nora's birthday invitation linked to Nora Chen and Nora's 70th Birthday event.
  3. 03 / Follow more than one thread

    Ask for the event and the place.

    Bluewater Weekend plus Bluewater Beach narrows the archive to the nine photos that belong to both.

    Cimmich filters showing the nine photos linked to both Bluewater Weekend and Bluewater Beach.

Matching that learns from your decisions

One confirmation can uncover the next.

You know who belongs in your photos. Cimmich uses the faces you confirm to look for more, and leaves each decision with you.

  1. Review a suggestion.

    Confirm the person, choose someone else or leave the photo for later.

  2. Refresh with what you know.

    Cimmich rebuilds its matching evidence from your confirmed faces, then searches again.

  3. See what comes back.

    Review any new possibilities or doubtful tags. If nothing else is ready, return after adding more evidence.

Cimmich New matches showing a previously untagged face, a Maya Chen suggestion and the Confirm Maya Chen action.
You have the final say. A suggestion waits for you to confirm or correct it.

Face matching needs a local Face-analysis provider and separately installed model files. Stories, documents and other organisation tools work without it.

What about a wrong tag or a difficult photo?
Cimmich Possible mistags showing an existing Maya Chen tag that the matcher believes is a stronger match for Samira Patel.
Question a doubtful tag. Review the alternative when another person looks like a better fit.
Cimmich retaining Maya Chen on the photo while the selected region is reclassified from Face to Head.
Keep the person, fix the evidence. Mark a region as Head or Body when it cannot support face matching. The photo stays connected to that person.

These fictional demo photos show the workflow, not a measure of matching accuracy.

Your knowledge should outlive one install

Move the library without leaving the story behind.

Cimmich reconnects unchanged photos by their contents, not only by where they live today. Move files or rebuild Immich and the people, events, places and documents you added can reconnect after a new inventory.

Your media platform Immich

Keeps authentication, original media, thumbnails and its own library metadata.

Your memory layer Cimmich

Keeps the people, stories, decisions and documents you add in a separate database.

Cimmich stores its own organisation. It does not write albums, tags, metadata or media back into Immich.

01

Same photo, same memory

Unchanged photos can reconnect after paths or Immich IDs change.

02

Edits stay honest

A changed file becomes a new asset instead of inheriting context automatically.

03

Take Cimmich with you

Export Cimmich's database and linked documents without copying original media.

Community Preview 18

Bring Cimmich to the library you already have.

Preview 18 requires exact Immich 3.1.0. The guided install has been tested on macOS and Linux Docker hosts; Windows has not yet been tested. Start with a no-change check of your setup, then install when the account, library and scope look right.

Prefer to explore without your own photos? The isolated Cedar House demo runs locally with fictional media. About the local demo.

Release v1.1.0-community-preview.18 at ce4534c Exact Immich 3.1.0 Tested macOS and Linux Checksum and source-build verified
Already downloaded the release? Check your setup

Open a terminal in the extracted release folder, then run:

./tools/install.sh --check

Kourai Khryseai

Explore what else we’re building.

Cimmich began with a simple idea: your photo library should remember more than filenames and faces. It’s one of the projects taking shape at Kourai Khryseai.

Explore Kourai Khryseai