How tanuj-manikanta-2007/snapcluster works
SnapCluster is a Django-backed AI photo organizer. Users authenticate, create or join a room, upload media, and retrieve its images; the backend stores media in Supabase and records room, URL, and face-embedding metadata. Face utilities detect and embed faces, while separate API operations cluster faces or search by a query photo. Upload, room, and AI API components are shown as distinct domain stages. The excerpts establish key calls, but do not expose every media-processing path or frontend request, so those links are omitted where uncertain.
Main entry points: urls.py URL Routing · media_views.py Media Upload & Retrieval · ai_views.py Cluster & Search APIs · models.py Room & Image Records
Components 14
Identity & UI
- Authentication & Pages
photos/views/auth_views.py - Photo Organizer UI
photos/static/js/app.js - URL Routing
photos/urls.py
Room Management
- Room Operations
photos/views/room_views.py - Room Code Generator
photos/utils.py
Media Handling
- Media Upload & Retrieval
photos/views/media_views.py
Face Intelligence
- Cluster & Search APIs
photos/views/ai_views.py - Face Detection & Embeddings
photos/face_utils.py - Face Clustering
photos/face_cluster.py
Persistence
- Room & Image Records
photos/models.py - Storage Client
photos/supabase_client.py
Other components
- User
- Supabase Storage
- Configured Database
Connections 17
- User → Authentication & Pages: signs in
photos/views/auth_views.py - User → Photo Organizer UI: uses
- User → URL Routing: requests
- URL Routing → Authentication & Pages: routes to
photos/urls.py - URL Routing → Room Operations: routes to
photos/urls.py - URL Routing → Media Upload & Retrieval: routes to
photos/urls.py - URL Routing → Cluster & Search APIs: routes to
photos/urls.py - Room Operations → Room Code Generator: generates code
photos/views/room_views.py - Room Operations → Room & Image Records: reads/writes
photos/views/room_views.py - Media Upload & Retrieval → Room & Image Records: reads/writes
photos/views/media_views.py - Media Upload & Retrieval → Storage Client: uploads media
photos/views/media_views.py - Media Upload & Retrieval → Face Detection & Embeddings: extracts faces
photos/views/media_views.py - Cluster & Search APIs → Room & Image Records: reads/writes embeddings
photos/views/ai_views.py - Cluster & Search APIs → Face Detection & Embeddings: detects query faces
photos/views/ai_views.py - Cluster & Search APIs → Face Clustering: clusters embeddings
photos/views/ai_views.py - Storage Client → Supabase Storage: connects
photos/supabase_client.py - Room & Image Records → Configured Database: persists records