automation

immich-autotag

Name: immich-autotag
Author: txemi

Rule engine to batch-organize an Immich photo & video library: auto-create albums, assign tags, fix dates — from a config file.

154 stars+3★ this week5 forksPythonUpdated 10/8/2026100% free · open source

What it does

Immich-autotag is a rule engine that automatically organizes your Immich photo and video library by creating albums, assigning tags, and fixing dates based on a configuration file.

When to use it

•You have a large, unorganized photo and video library in Immich and want to automatically categorize it.
•You need to consistently apply specific tags or albums to new photos and videos in your Immich library.
•You want to batch-update the metadata of your photos and videos in Immich, such as dates or descriptions.

Ready-to-paste prompt

immich-autotag -c config.yaml --rule 'create album "Vacation" for files containing "vacation" in the file name'

Heads up: Make sure you have the Immich API credentials set up correctly in your configuration file, as immich-autotag requires access to the Immich API to organize your library.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/immich-autotag && curl -fsSL https://workflowstacks.com/api/skills/immich-autotag/claude-skill -o ~/.claude/skills/immich-autotag/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How immich-autotag works

Codeflow

Free to inspect

Immich-autotag is a large Python project (~29k lines across 389 code files, plus 1 test files). Setup is light: installs like a normal app. Reading the code is optional. Last commit this month, Other license, has a test suite.

Size

Large codebase

~29k lines · 389 code files · ~4 h to skim

Setup

One-command install

Installs like a normal app. Reading the code is optional.

Runs on

Python · Docker

No API keys detected

Python 89%Shell 11%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
CLAUDE.md
The instructions the AI actually follows
3
main.py
Where the program starts running
4
pyproject.toml
Dependencies and the commands it exposes
5
immich_autotag/__init__.py
Inside immich_autotag/ — the main logic begins here

What's in each folder

immich_autotag/Core code — the actual logic317 files

docs/Documentation157 files

scripts/Helper scripts73 files

tools/Helper scripts6 files

docker/Deployment / infrastructure2 files

immich_api_examples/Folder2 files

hooks/Hooks — scripts that auto-run on events1 files

jenkins_logs/Folder1 files

READMEHas testsDocumentedCI checksDocker readyOther licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/immich-autotag && curl -fsSL https://workflowstacks.com/api/skills/immich-autotag/claude-skill -o ~/.claude/skills/immich-autotag/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

txemi

Language

Python