Immich
Immich is a self-hosted photo library. This shows a flashback of photos from this day, and lets the assistant search photos and people.
Set it up
Section titled “Set it up”integrations: immich: type: immich url: http://immich:2283 apiKey: ${IMMICH_APIKEY} href: https://photos.example.com
layout: - title: Media widgets: - immich.memories| Option | Type | Default | What it does |
|---|---|---|---|
url | URL | required | Where the service answers, from Valet’s side. |
apiKey | string | required | An API key with read permissions. Use ${VAR}. |
href | string | optional | Where the card links to, when that differs from url. |
Widgets
Section titled “Widgets”One widget. Its key is immich.memories, using the instance name from your config.
On this day
Section titled “On this day”immich.memories · photos card · refreshes every hour while the page is open.
States
Section titled “States”
Assistant tools
Section titled “Assistant tools”What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.
| Tool | Access | What it does |
|---|---|---|
photos_search | read | Search the person’s photos and videos in Immich by what’s in them (smart search: “sunset at the beach”, “birthday cake”, “dog in snow”), optionally narrowed to people (by name), a date range or a city. |
photos_people | read | The people Immich recognises (named faces), to search photos of someone. |
Year in review
Section titled “Year in review”Slides this integration adds to the recap.
