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.
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 for the waitlist at www.gumnut.ai/waitlist. Once approved, you’ll receive an invitation to create your account.Accessing Gumnut from a Browser or Phone
Gumnut’s own web and mobile apps are currently a work in progress. In the meantime, the best way to access your photos from a browser or phone is through the Immich apps. Immich is a popular open-source photo management project, and Gumnut provides an Immich API compatibility layer so the Immich apps work directly with your Gumnut library — no extra setup required. 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://photos.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 photos.gumnut.ai
- Log in with your Gumnut credentials
- Drag and drop photos or use the upload button
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.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 photos.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