Skip to main content
This guide walks you through creating your account and choosing how to upload, view, and manage your photos with Gumnut.

​
Create Your Account

If you don’t already have an account, sign up at app.gumnut.ai/sign-up.

​
Accessing Gumnut from a Browser or Phone

The Gumnut web app at app.gumnut.ai is the primary way to browse your library from a browser. It gives you a photo timeline, albums, people, search, a map, and an asset viewer. You can also use the Immich mobile app. Immich is a popular open-source photo management project, and Gumnut provides an Immich API compatibility layer so the mobile app, with automatic camera-roll backup, works directly with your Gumnut library, with no extra setup. For details on what works and what doesn’t through the compatibility layer, see the Immich compatibility overview.

​
Upload Your Photos

Once you have an account, you can upload photos in several ways. For photos stored only in Google Photos or iCloud, follow Import from Google Photos or iCloud to export the files and bring them into Gumnut.

​
Immich Mobile App

Upload photos directly from your phone using the Immich mobile app:
  1. Download the app from the App Store or Google Play
  2. Set the server URL to https://immich.gumnut.ai
  3. Log in with your Gumnut credentials
  4. Upload photos from your camera roll, or enable automatic background backup

​
Gumnut Web App

Upload from the Gumnut web app:
  1. Go to app.gumnut.ai
  2. Log in with your Gumnut credentials
  3. Drag and drop photos onto the timeline. When the upload finishes cleanly, use Add to album on the progress card to file them — or drop them straight onto an album’s page to upload directly into it. You can also select photos in the timeline later and use Add to Album.
To upload a whole folder, choose Upload folder from the Photos or album page, or drag the folder onto either page. Gumnut scans nested folders and uploads the photos and videos it finds. Common folder metadata and sidecar files are skipped automatically, so they do not appear as individual upload errors.

​
REST APIs and SDKs

For programmatic access, use Gumnut’s REST API or native SDKs to upload photos from your own applications and scripts. Get started with the API → Whichever upload method you choose, Gumnut automatically avoids storing exact duplicate files more than once in the same library. Learn what counts as a match in Duplicate Detection.

​
View and Manage Your Photos

After uploading, you have several ways to browse, organize, and work with your photos.

​
Gumnut Web App

app.gumnut.ai gives you a photo timeline, albums, people, search, a map view, and an asset viewer, plus API key management, an Immich setup page, and an AI Agents page for connecting MCP clients.

​
Immich Mobile App

Browse your library on the go, create albums, and favorite photos — all from the same app you used to upload.

​
REST APIs and SDKs

Build custom applications and workflows using the REST API or native SDKs for TypeScript and Python.

​
MCP Server

Connect AI assistants like Claude, Cursor, or ChatGPT to your photo library using Gumnut’s MCP server. Use natural language to search, organize, and manage your photos. Set up the MCP server →

​
Next Steps