v3.0.10 - 2026-06-27

🔁 v3.0.10 - 2026-06-27

tl;dr

• We have revamped the UI using electron
• Performance enhancements using indexes in METADATA db and using onxx runtime
• Functionality to give names to detected faces
• Added Search with text on images with reranking (You can search "Abhishek trekking" and it will only show images for Abhishek on top of list)
• Changes in github workflow

SnapSort continues to evolve as your go-to desktop application for offline, AI-powered image sorting and semantic searching. With a complete architectural overhaul and significant feature upgrades, v3.0.0 transitions SnapSort into a professional, standalone desktop application. No more Python prerequisites or manual installations! Simply download the installer for your platform, select a folder of photos, and SnapSort will detect faces, index semantic embeddings, and allow you to:

• Search for photos by typing natural descriptions (e.g., "tree in sunset", "group of people outdoors") using advanced semantic search.
• Search for photos by typing a specific tagged person's name combined with context (e.g., "Rahul hiking").
• Enjoy a true "double-click to run" experience on Windows, macOS, and Linux with our new seamlessly bundled AI engine.

Changes

🧠 Functionality

• Semantic Image Search (CLIP): A powerful new feature utilizing Xenova CLIP to allow natural language text-to-image searching, enabling you to find photos by simply describing what's in them.
• Standalone AI Engine: The Python backend (FastAPI, YuNet, SFace, CLIP) is now compiled into a highly optimized, fully bundled executable using PyInstaller. You no longer need to install Python or use pip!
• Persistent Vector Storage: Upgraded to FAISS for lightning-fast high-dimensional vector similarity search for both face features and semantic embeddings.

🎨 User Interface & Experience

• Electron + React Frontend: A completely rebuilt, blazing fast desktop interface using React (TypeScript) and Zustand for state management, seamlessly wrapped in an Electron shell.
• About & Settings Polish: Added the official SnapSort logo to the About page and a convenient "Report a Bug" link in the settings menu that directs straight to GitHub issues.
• Automated Installers: One-click installers (.exe, .dmg, .AppImage) are now automatically generated via GitHub Actions and electron-builder.

🛠️ Codebase Improvements

• Multi-Worker Processing: Completely revamped the backend controller to use a multi-processing pool for background indexing, achieving ~2.5 - 3 images per second on standard CPUs without blocking the UI.
• AI Agent Context: Added an AGENTS.md file to act as canonical context documentation, allowing AI coding assistants to seamlessly contribute to future development.
• Benchmarking Tools: Included a new benchmark.py script to easily test and measure local hardware performance on the heavy machine learning pipeline.

v2.0.0

🔁 v2.0.0 - 2025-06-04

SnapSort continues to evolve as your go-to desktop application for offline, face-based image sorting and viewing. With a sleek, modern interface and significant feature upgrades, v2.0.0 enhances both usability and accuracy through a human-in-the-loop feedback system. Simply select a folder of photos, and SnapSort will detect faces, index them, and allow you to:

• Click any photo to see the faces it contains.
• Click a face thumbnail to filter the gallery to every image that person appears in.
• Use the new "Merge Faces" option to manually group similar-looking but uniquely identified faces.

Changes

🧠 Functionality

• Human Feedback Loop for Face Grouping
  A powerful new feature that allows users to manually merge different detected faces of the same person. A separate interface window displays all face thumbnails, enabling the user to select and group them together for more accurate filtering.

🎨 User Interface & Experience

• Dark Mode support for comfortable viewing.
• A refreshed, modern-looking GUI with improved navigation and layout.

🛠️ Codebase Improvements

• Major code refactoring and modularization for better maintainability.
• Added docstrings across modules to improve readability and developer onboarding.

v1.0.0

🔁 v1.0.0

SnapSort is a cross-platform desktop application for offline, face-based image sorting and viewing. Select a folder of photos and instantly browse thumbnails; in the background, SnapSort will detect faces, build a searchable embedding index, and let you:

• Click any photo to see the faces it contains.
• Click a face thumbnail to filter the gallery down to every image where that person appears.
• Hit “Back to All Images” to return to your full gallery.

🧠 Core Functionality

• Display faces in the selected image
  When an image is selected, the application shows all the faces that it detected in the image. Clicking on the faces shown will filter the with images in which the person appears.

• Display related images with shared faces
  When an image is selected, show all other images where the same people (faces) also appear together.

Installers

• Create installers for Windows, Linux, and macOS

What's Changed

• [ui] Update image viewer when similar photo is clicked by @ASK-03 in #1
• [chore][db] Skip already processed images during folder scan by query… by @ASK-03 in #2
• [fix] add boundary condition for no image_paths and image_faces by @ASK-03 in #3
• [fix] image with no face not showing by @ASK-03 in #4
• [fix] image with no face not showing by @ASK-03 in #5

New Contributors

• @ASK-03 made their first contribution in #1

Full Changelog: https://github.com/ASK-03/SnapSort/commits/v1.0.0