Skip to main content
This page summarizes the most significant user- and developer-facing changes to Gumnut each month. For a detailed, itemized list of changes, see the detailed changelog.
​
EditingLibrariesSearchUploads
  • Photo editing. Added a browser editor for cropping, rotating, and mirroring photos, with support for reopening saved edits and reverting to the original.
  • Multiple libraries and sharing. Added library creation and switching, plus Viewer and Collaborator roles, member management, and invitation links with QR codes.
  • Search and browsing. Added an always-open search filter rail, media-type filtering, and browser history for submitted searches. Improved timeline navigation, viewer transitions, and returns to cached photo grids.
  • Folder uploads and queues. Added folder uploads and a queue for new batches submitted while another upload is running.
  • Assistant and MCP. Published the Gumnut plugin in ChatGPT. Added support for Grok and Muse alongside ChatGPT and Claude, and improved compatibility with other MCP clients.
  • Immich compatibility. Updated compatibility to Immich v3.2.0, added a library selector in Gumnut settings, and corrected original-versus-edited batch downloads.
​
FavoritesBrowsingPerformanceImmich
August made browsing, editing, and Immich sync substantially more capable.
  • Browsing filters. Photos, album, and map views gained composable People, Date, Album, and media-type filters. You can combine them to build precise views—for example, photos of two people from a particular year and location.
  • Favorites. Favorites arrived with heart and keyboard shortcuts, tile badges, bulk favorite/unfavorite actions, and a favorite filter that can be combined with the other browsing filters.
  • Faster, more polished web app. Browsing data now restores across visits and refreshes in the background while keeping usable results visible.
  • Versioned assets. Added support for reading and writing asset versions, including append, replace, revert, and delete operations. Clients can now save edited renderings while retaining their relationship to the original upload and restore the original when needed.
  • Broader Immich compatibility. Immich clients gained event-driven stack sync and stack removal, streamed batch downloads, non-destructive editing routes with original-versus-edited downloads, and working favorites.
​
MapBurstsSearchAPI
New map view and automatic burst grouping, alongside a substantially better search stack.
  • Map view. The web app gained a Map view that plots where your photos were taken as a heatmap over a self-hosted basemap. Hover a hotspot for a summary, click to drill into those photos, filter by date, people, or album, and step through the results in the viewer. The asset info panel also shows a small map preview.
  • Burst photos group automatically. Gumnut now detects burst sequences and collapses them into a single timeline tile with a frame count. In the viewer you can set the cover frame, remove a frame, or unstack the burst, and you can stack selected photos by hand. Immich clients see the same stacks.
  • Better search results. Search now fuses dense and sparse retrieval and reranks the top candidates with a cross-encoder, backed by new full-text indexes over camera and place metadata. Latency under concurrent load dropped at the same time.
  • Location and filter APIs. A new geo-clusters endpoint clusters assets by location, and list_assets and search_assets gained radius and bounding-box filters, an album filter, and ascending order. API keys now require an explicit scope, and library-scoped keys can upload.
  • Immich compatibility. The adapter now targets Immich v3.1.0 and implements stacks, camera and place search filters, and /search/random and /search/explore, with a batch of immich-go fixes.
  • App polish. Advanced search filters, long-press multi-select, pinch-to-zoom and swipe gestures in the viewer, an in-app feedback form, and an AI-generated description preview beside the editable caption.
​
WebsiteAppsVideoFaces
A rebrand month: a brand-new public website launched alongside a full visual refresh of the web app, with big additions to albums, people, video, and faces.
  • New public website. A rebuilt marketing site launched at gumnut.ai, with new Home, Platform, Enterprise, About, and Contact pages.
  • Rebranded web app. The web app adopted the Gumnut design system, including a new dark mode, a branded sign-in, and a new Gumnut-hosted sign-up page.
  • More library management in the app. Create, rename, and delete albums; rename, merge, and set a featured face for people; single- and multi-photo downloads; move-to-trash; and faster parallel uploads with an ETA.
  • Video in the viewer. Videos now play in the web asset viewer, with thumbnails across the timeline, grid, and MCP app, HDR tone-mapping, and a batch of paging fixes.
  • New MCP tools. view_asset returns a photo’s pixels to the model for inspection, and save_asset ingests new photos and videos into a library.
  • Better face detection. A new SCRFD detector became the default, and you can now draw or delete face boxes by hand.
​
AppsVideoFaces
The biggest month yet, headlined by a brand-new Gumnut app and the first release of video support.
  • New Gumnut web app. A rebuilt, Vite-based single-page app launched at app.gumnut.ai, fully replacing and retiring the previous Next.js web client. It ships a fast, virtualized photo timeline with infinite scroll, an asset viewer with EXIF metadata, albums, people, search, uploads, API key management, and Immich and MCP setup pages. A matching mobile timeline landed in parallel.
  • Basic video support. Videos now get thumbnails, duration, and streaming playback through the CDN (including HTTP range requests), with full end-to-end support through the Immich adapter.
  • Trash and restore. Library-level trash/restore with an async purge window, plus Immich-compatible soft-delete so deletions sync correctly to Immich clients.
  • Smarter face clustering. Switched to graph-based clustering (HNSW + Chinese Whispers), added crowd-face filtering, and shipped an operator face cleanup dashboard. Began migrating face embeddings to ArcFace.
  • Closing Immich feature gaps. Map markers, “On this day” memories, and user edits to asset metadata (description, date/time, and GPS).
​
GeocodingFacesImmichApp
  • Location data. Reverse geocoding now adds human-readable place names and location metadata to your assets.
  • Face clustering quality. Density-aware gates, auto-merge, debouncing, and quality filtering significantly improved face grouping accuracy.
  • CDN migration completed. Asset delivery through the CDN was finished end-to-end, including the Immich adapter.
  • More Immich compatibility. People merge, faces, and reassignment endpoints; soft-delete (trash) backend; and compatibility with newer Immich releases.
  • New app foundations. Scaffolding for the new web and mobile apps, including shared packages and the authentication flow.
  • MCP and ChatGPT. MCP app refinements plus the groundwork for the ChatGPT app submission (privacy policy, demo account, and the merge_people tool).
​
CDNDescriptionsMCPFaces
  • AI image descriptions. Gumnut now generates descriptions for uploaded assets using provider-agnostic inference (OpenRouter and Google Gemini), with descriptions available through the API.
  • CDN asset serving. Cloudflare-based CDN delivery rolled out across the API, web app, MCP app, and SDKs for faster image loading.
  • MCP app stabilization. Theme support (dark/light), configurable CSP, iframe sizing, and hardened error handling.
  • Search and people. Search and filter people by name, and a new endpoint to merge people.
  • Performance. Faster deploys (~30 min → ~5 min), streamed uploads, and per-user rate limiting.
​
AlbumsAPIMCP
  • Album covers. Albums now expose cover images and thumbnails.
  • API improvements. Batch ID filtering on list endpoints, date-range filtering on assets, and full URLs returned directly in responses.
  • Next-generation MCP. Completed client migration, deprecated the legacy MCP server, and added stateless HTTP mode for horizontal scaling.
  • Faster faces. Face detection moved to a local task and images are downscaled first, speeding up processing.
  • Reliability and security. First-class event modeling for sync, cursor pagination fixes, and cross-library access hardening.
​
MCPHEICImmich
  • Next-generation Gumnut Photos MCP. Shipped the MCP foundation, the full Tier 1 toolset, complete MCP authentication, and tool enhancements (structured content, output schemas, titles).
  • HEIC support. Fixed HEIC metadata and ML processing, and pre-generated full-size WebP so HEIC photos display in the browser.
  • Immich adapter. WebSocket infrastructure with authentication, sync streaming, Immich-compatible error formatting, and an update to Immich v2.4.1.
​
ImmichSync
  • Immich adapter in production. Deployed the Immich compatibility layer, adding sessions, checkpoints, and the /session endpoints.
  • Sync foundations. A new events endpoint for client sync, plus SHA-1 checksum support and device_id / device_asset_id filtering for Immich clients.
  • Albums. Added start and end date fields to album responses.