Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumnut.ai/llms.txt

Use this file to discover all available pages before exploring further.

Immich is a popular open-source, self-hosted photo and video management platform with polished web and mobile apps. Gumnut provides an Immich API compatibility layer, so you can use the Immich mobile and web apps with your Gumnut photo library. This is powered by immich-adapter, an open-source reverse proxy that translates Immich API calls into Gumnut API calls. Gumnut runs this for you — you don’t need to deploy it yourself.

​
Getting Started

You can access your Gumnut library through the Immich apps right away:
  • Web app — Browse your library at photos.gumnut.ai
  • iOS app — Download from the App Store, set the server URL to https://photos.gumnut.ai
  • Android app — Download from Google Play, set the server URL to https://photos.gumnut.ai
Log in with your Gumnut credentials. The mobile app supports automatic background backup of your camera roll.

​
Why Use Gumnut with Immich

Gumnut is an AI-powered photo platform that gives you the familiar Immich experience plus capabilities that aren’t available with a standard Immich server:
  • MCP server and MCP App — Connect AI assistants like Claude, Cursor, and ChatGPT directly to your photo library. The MCP App provides a rich interactive UI for browsing and managing photos within MCP-compatible clients.
  • AI description generation — Gumnut automatically generates searchable descriptions of your photos using vision language models
  • Photo quality scoring — Every photo is scored for technical and aesthetic quality, helping you find your best shots
  • More accurate face detection and people grouping — Gumnut’s recognition pipeline goes beyond Immich’s per-face matching for cleaner, more accurate people groups. See Faces and People for details.
  • Fast image serving from a global CDN — Gumnut serves your photos through Cloudflare’s global CDN backed by S3-compatible cloud storage, so they load quickly from anywhere — without the upload-bandwidth limits or internet exposure of serving from a home server.
  • Full API access — A REST API, TypeScript and Python SDKs, and webhooks for building custom workflows
If you’re already familiar with Immich, Gumnut lets you keep using the apps and workflows you know while gaining access to these additional capabilities.

​
Gumnut Is Not a Hosted Immich Provider

Gumnut is an AI photo platform with Immich compatibility — not a hosted version of the Immich server. The Immich apps connect to Gumnut’s own backend through the compatibility layer, and some Immich features work differently or aren’t available. If you’re looking for a hosted Immich server that runs the official Immich software, consider these providers. None of these providers are associated with or vetted by Gumnut.
  • PikaPods — Instant open-source app hosting with weekly updates and encrypted backups
  • Elestio — Fully managed Immich on dedicated VMs across multiple cloud providers
  • ElfHosted — Managed Immich hosting with bring-your-own storage
  • Cloudron — Self-hosted app platform with one-click Immich installation
  • PeakNetworks — European hosting with data centers in Switzerland, Germany, and Austria
  • Yundera — Private cloud server with one-click app installs including Immich

​
Contributing

The immich-adapter is open source. If you’d like to contribute to improving Immich compatibility, visit the immich-adapter repository on GitHub.