> ## 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

> Get up and running with Gumnut in minutes

# 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](https://app.gumnut.ai/sign-up).

## Accessing Gumnut from a Browser or Phone

The Gumnut web app at [app.gumnut.ai](https://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](https://immich.app) 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](/guides/immich/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:

1. Download the app from the [App Store](https://get.immich.app/ios) or [Google Play](https://get.immich.app/android)
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](https://docs.immich.app/features/mobile-backup)

### Immich Web App

Upload photos through your browser:

1. Go to [immich.gumnut.ai](https://immich.gumnut.ai)
2. Log in with your Gumnut credentials
3. Drag and drop photos or use the upload button

### Gumnut Web App

Upload from the Gumnut web app:

1. Go to [app.gumnut.ai](https://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**.

### 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 →](/guides/apis/overview#getting-started)

## 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](https://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](https://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](/guides/apis/overview) or native SDKs for [TypeScript](/guides/sdks/typescript) and [Python](/guides/sdks/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 →](/guides/mcp/setup)

## Next Steps

* [API Overview](/guides/apis/overview) — Make your first API calls
* [SDKs](/guides/sdks/overview) — Use native TypeScript or Python SDKs
* [MCP Setup](/guides/mcp/setup) — Connect AI assistants to your library
* [Authentication](/guides/authentication/overview) — Learn about API keys and OAuth