# Immich-machine-learning

Immich-machine-learning is a self-hosted ai app. Machine-learning service for Immich (face recognition, smart search, etc). It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2923/immich-machine-learning

## Description

Machine-learning service for Immich (face recognition, smart search, etc). This is the "immich-machine-learning" service from the official Immich docker-compose.yml. It must be on the same custom Docker network ("immich") as the Immich server, which reaches it at http://immich-machine-learning:3003 via the IMMICH_MACHINE_LEARNING_URL setting. It exposes port 3003 only on the internal network (no host port published). For hardware-accelerated inference, switch the repository tag to one of: release-armnn, release-cuda, release-rocm, release-openvino, release-rknn, and add the relevant device(s) - see https://docs.immich.app/features/ml-hardware-acceleration.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

74/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 17 days ago)
- Popular: 100 (118,238 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (6 GB minimum RAM)

## Links

- Official website: https://immich.app/
- Documentation: https://docs.immich.app/features/ml-hardware-acceleration
- GitHub: https://github.com/immich-app/immich
- Unraid: https://ca.unraid.net/apps/immich-machine-learning-1kefz1w0yq1lm0?q=immich-machine-learning

## Common questions

### How do I enable GPU acceleration for Immich machine learning?

Change the machine-learning image tag to a backend-specific release tag, such as release-cuda or release-rocm, and pass the relevant device into the container. The feature is still experimental and may not work on all systems.

### Why might the machine-learning container fail to start with a libGL error?

It may fail to start because the libGL.so.1 library is missing.

### What should I do if machine learning uses too much CPU or memory?

You can mitigate this, host the machine-learning container on a more powerful system, or disable machine learning entirely.

### What backup approach does Immich recommend for photos and videos?

Follow a 3-2-1 backup plan for your photos and videos.

## Alternatives

- ChronoFrame: ChronoFrame is a self-hosted photo gallery for homelab users who want a private, low-maintenance place to upload, organize, and share perso…
- Ente Photos: Open-source, end-to-end encrypted backup and sharing for photos and videos, with multi-platform sync, original quality, privacy controls, a…
- Frameleaf Manager: Frameleaf Manager is the guided installer and upgrade tool for the self-hosted Frameleaf photo and video library.
- Go-vod: Go-vod is a minimal, self-hosted video transcoding server for the Memories Nextcloud photo app that exposes stored media as HTTP Live Strea…
- Google Photos: Cloud storage offering 15 GB free space, automatic album and duplicate organization, AI editing, cross-platform sharing, and secure backups.
- HomeGallery: HomeGallery is a self-hosted, open-source web gallery for browsing personal photos and videos while keeping your original file and folder s…
- PhotoPrism: PhotoPrism is a self-hosted, AI-powered photo and video manager.
- Piwigo: Piwigo is a self-hosted, open-source photo gallery for the web that lets you publish, organise, and share your picture collection with powe…
- Proton Drive: Emphasizes privacy with end-to-end encryption, Proton Drive safely stores, synchronizes, and shares files across devices via web and mobile…
- TinyCld: Open source suite for mail, calendar, drive, and contacts with self-hosting, privacy, zero cost, open standards, versioned files, and unifi…
- foldergram: Foldergram is a self-hosted, local-first web gallery that scans folders for photos and videos and displays them in a fast, Instagram-style…
- librephotos: LibrePhotos is a self-hosted, open-source photo management service for organizing and browsing photo and video collections.

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