explaingit

jeba-jebarsan/ai-event-photo-finder

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

Photographers upload event photos, and guests scan a QR code and take a selfie to instantly get only their own photos back.

Mindmap

mindmap
  root((Photo Finder))
    What it does
      Upload event photos
      Match guest selfies
      Return only their photos
    Tech stack
      Next.js
      FastAPI
      InsightFace
      Supabase
    Use cases
      Wedding photo delivery
      Conference photo sharing
      Self hosted alternative
    Audience
      Developers
      Event photographers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let wedding or event guests find and download only the photos they appear in, without scrolling through hundreds of images.

USE CASE 2

Build a self-hosted alternative to paid event photo sharing services using face matching.

USE CASE 3

Study a real example of combining a Next.js frontend with a separate Python face recognition service.

USE CASE 4

Prototype a QR code based photo delivery flow for conferences or parties.

What is it built with?

Next.jsTypeScriptFastAPIPythonSupabase

How does it compare?

jeba-jebarsan/ai-event-photo-finderagbara286/saint-cmsanuj-kumary/your-github-contributions
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-07
MaintenanceMaintained
Setup difficultyhardeasymoderate
Complexity4/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires running a separate Python AI service, setting up a Supabase project, and an HTTPS tunnel to test the camera flow on a phone.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

AI Event Photo Finder solves a problem anyone who has been to a wedding or conference knows well: a photographer takes hundreds of photos, and finding the ones you're actually in means scrolling through all of them. This project lets a photographer upload every photo from an event once, and then lets each guest instantly get back only their own photos. Here is how it works. A photographer creates an account, sets up an event, and uploads the full set of photos. The system then scans every photo, detects each face in it, and creates a mathematical representation of each face on the server. The event gets its own QR code, which the photographer shares with guests, for example by printing it or displaying it at the venue. A guest scans the code, takes a live selfie through a guided capture process that checks the photo quality, and within seconds gets back the photos from that event where their face was matched, sorted by how confident the match is. No app install or account is needed on the guest side. The project is split into two parts. The web app is built with Next.js and TypeScript, styled with TailwindCSS, and handles accounts, event creation, uploads, QR codes, and the guest facing flow. The face detection and matching is a separate Python service built with FastAPI, using an open source face recognition library called InsightFace. Supabase provides the database, authentication, and file storage behind the scenes. According to the project's status notes, the core flow from uploading photos to getting matched results back works end to end, but the project has not been deployed publicly yet. Known open items include moving to a more scalable way of storing face data for handling many events at once, notifying guests when their photos are ready, figuring out pricing, and writing a formal privacy policy for handling biometric face data, which the maintainers flag as still missing. The project is released under the MIT license and welcomes outside contributions, while noting it is early stage and may have rough edges.

Copy-paste prompts

Prompt 1
Walk me through setting up the ai-service and the Supabase project so I can run this locally.
Prompt 2
Explain how face detection and matching work in this project using InsightFace.
Prompt 3
Show me how the QR code connects a guest's selfie to the right event's photo set.
Prompt 4
Help me test the guest camera flow on my phone using an HTTPS tunnel.
Prompt 5
What privacy considerations should I address before deploying a face recognition app like this?

Frequently asked questions

What is ai-event-photo-finder?

Photographers upload event photos, and guests scan a QR code and take a selfie to instantly get only their own photos back.

What language is ai-event-photo-finder written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, FastAPI.

What license does ai-event-photo-finder use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ai-event-photo-finder to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ai-event-photo-finder for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.