Quickstart
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 apps. Immich is a popular open-source photo management project, and Gumnut provides an Immich API compatibility layer so the Immich apps — including the mobile app, with automatic camera-roll backup — work 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.Immich Mobile App
Upload photos directly from your phone using the Immich mobile app:- Download the app from the App Store or Google Play
- Set the server URL to
https://immich.gumnut.ai - Log in with your Gumnut credentials
- Upload photos from your camera roll, or enable automatic background backup
Immich Web App
Upload photos through your browser:- Go to immich.gumnut.ai
- Log in with your Gumnut credentials
- Drag and drop photos or use the upload button
Gumnut Web App
Upload from the Gumnut web app:- Go to app.gumnut.ai
- Log in with your Gumnut credentials
- 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.
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 →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.Immich Web App
The web interface at immich.gumnut.ai provides a full-featured experience for browsing, searching, organizing albums, and managing people.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
- API Overview — Make your first API calls
- SDKs — Use native TypeScript or Python SDKs
- MCP Setup — Connect AI assistants to your library
- Authentication — Learn about API keys and OAuth