Image Organizer

Advanced image management system with AI-powered face clustering, visual similarity detection, and interactive 3D visualizations.

📸

Face Detection & Recognition

Automatically detect faces in images and group them by person using ArcFace embeddings and DBSCAN clustering.

🎨

Visual Similarity Clustering

Group visually similar images using perceptual hashing and color histogram analysis for thematic organization.

📊

Interactive 3D Visualizations

Explore face clusters in interactive 3D scatter plots powered by Deck.gl with real-time filtering and highlighting.

⚡

Performance Optimized

Parallel thumbnail generation, SQLite optimization, and bulk processing for handling large image collections.

Interactive Face Cluster Visualization

Explore a sample dataset of face embeddings visualized in 3D space. Points represent individual faces, colored by person identity, with size scaled by image count.

Loading 3D Visualization...

Initializing Deck.gl and loading sample data

-
Faces
-
Persons
-
Named
-
Unnamed

📁 Smart Organization

Automatically organize images by date, location, and content using EXIF metadata and AI analysis.

🔍 Advanced Search

Search by visual similarity, face recognition, or semantic content using CLIP embeddings.

🖼️ Quality Filtering

Automatically score image quality (sharpness, exposure, noise) and filter low-quality images.

📈 Performance Analytics

Monitor processing times, cache performance, and system metrics with detailed reporting.

🚀 Get Started with Image Organizer

  1. Installation: Clone the repository and install dependencies with uv sync
  2. Database Setup: Run migrations to initialize the SQLite database
  3. Import Images: Use the CLI to scan directories and import images with metadata extraction
  4. Process Images: Run face detection, clustering, and thumbnail generation
  5. Launch Web UI: Start the FastAPI server and explore your organized collection
# Clone the repository
git clone https://github.com/yourusername/image-organizer.git
cd image-organizer

# Install dependencies
uv sync

# Run migrations
uv run alembic upgrade head

# Import images from a directory
uv run python -m image_organizer.cli import /path/to/images

# Start the web server
uv run python -m image_organizer.api.cli serve

Check the project documentation for detailed usage instructions and configuration options.