Immichpy

Immichpy is the stable, typed Python API layer for Immich automation and integrations. It provides a Python client and CLI so you can interact with your Immich server programmatically or from the terminal, with full type safety and async support. The library is auto-generated from the Immich OpenAPI schema and stays in sync with upstream releases.

You can read the documentation, install it from PyPI, and view the source on GitHub.

Intention

I’ve been working a lot with OpenAPI-related tooling recently: I added OpenAPI descriptions to Immich in a massive PR, maintain multiple OpenAPI-generated clients in Python and TypeScript, and suggested a client rewrite for the Lichess API (berserk).

Timeline

The project started in January 2026, after setting up my Immich server and contributing to Immich.

It was first named immich-python-client (too long), then immich-py - but the package and CLI name immich shadowed module names and was ambiguous with the official CLI, so I renamed it to immichpy with consistent naming.

I’m currently working towards ecosystem integration. ¹

Tech Stack

See the Credits page for more details.