# immich_chromacluster

immich_chromacluster is a self-hosted automation app. ChromaCluster — Smart Immich Album Creator powered by advanced multi-signal feature analysis. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/9067/immich-chromacluster

## Description

ChromaCluster — Smart Immich Album Creator powered by advanced multi-signal feature analysis. Automatically discovers and proposes albums by fusing GPS coordinates, Immich machine learning visual analysis (CLIP Smart Search & facial recognition), perceptual CIELAB chroma/color-tone clustering, EXIF camera & lighting metadata, and time patterns, with human-in-the-loop review before syncing to Immich.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

39/100 (Low), based on 3 of 4 factors.
- Maintained: 72 (last commit 0 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_0a38448b98c278d5
- GitHub: https://github.com/NishantJh/immich_autoalbums

## Common questions

### What environment settings are required for ChromaCluster to sync with Immich?

Set IMMICH_URL and IMMICH_API_KEY in the app's .env file for live sync. The Immich API key is kept server-side and is not exposed to the browser.

### Where is ChromaCluster's local analysis data stored?

It caches CIELAB histograms and 5-color palettes in a SQLite file named organizer.db. The Unraid template maps /mnt/user/appdata/immich-autoalbums to /app/data for persistence.

### Which port should be reversed proxied or forwarded for ChromaCluster?

The app uses port 3000 in the Docker setup and the Unraid Community Applications template.

### Can repeat runs create duplicate Immich albums?

Syncing is described as idempotent. It creates the album with POST /api/albums on first sync and adds new assets with PUT /api/albums/{id}/assets when new trip photos arrive.

### Does ChromaCluster include WhatsApp, Downloads, or screenshot folders by default?

No, its pre-filter excludes configured paths such as WhatsApp, Downloads, and Screenshots. It also skips suspected screenshots that lack camera EXIF and have a screen-like aspect ratio.

---
Source: Our Local Host (https://ourlocalhost.com/app/9067/immich-chromacluster), the self-hosted and open-source app directory.
