Skip to main content

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.

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.
​
May 2026
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).
​
April 2026
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).
​
March 2026
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.
​
February 2026
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.
​
January 2026
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.
​
December 2025
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.