How pranith2610/2047_image_judging_engine works
THE 2047 is a web-based image judging platform for memory-and-recreation competitions. Organizers submit a reference image and participant recreations; the API validates uploads and invokes the coordinator, which analyzes the reference once, evaluates participants, scores and explains comparisons, then ranks results. The product also documents calibration, session management, review flags, and result exports. The README documents the main judging stages; sampled source and the SOURCE INDEX support the component links shown. Some UI/API wiring and details of unsampled capabilities are not verified, so those connections are omitted.
Main entry points: coordinator.py Pipeline coordinator · routes.py Competition API · schemas.py Profiles and results · reference.py Reference analyzer
Components 19
Web interface
- Competition dashboard
app/templates/index.html - Dashboard assets
app/static/js/app.js
API and intake
- FastAPI application
app/main.py - Competition API
app/api/routes.py - Image validator
app/core/validator.py - Image uploads
uploads
Judging pipeline
- Pipeline coordinator
app/core/coordinator.py - Reference analyzer
app/core/analyzers/reference.py - Participant analyzer
app/core/analyzers/participant.py - Semantic detector
app/core/analyzers/semantic_detector.py - Feature comparator
app/core/comparators/comparator.py - Weighted scoring
app/core/scoring/engine.py - Judging explanations
app/core/explanations/engine.py - Leaderboard ranking
app/core/ranking/engine.py - Profiles and results
app/models/schemas.py
Competition operations
- Calibration analysis
app/core/calibration/analyzer.py - Session files
sessions
Other components
- Organizer
- Competition results
Connections 23
- Organizer → Competition dashboard: uses
README.md - FastAPI application → Competition API: mounts routes
app/main.py - Competition API → Image validator: validates images
app/api/routes.py - Competition API → Image uploads: stores uploads
app/api/routes.py - Competition API → Pipeline coordinator: starts evaluation
app/api/routes.py - Competition API → Calibration analysis: requests analysis
app/api/routes.py - Pipeline coordinator → Reference analyzer: analyzes reference
app/core/coordinator.py - Pipeline coordinator → Participant analyzer: analyzes recreations
app/core/coordinator.py - Pipeline coordinator → Feature comparator: compares profiles
app/core/coordinator.py - Pipeline coordinator → Weighted scoring: calculates scores
app/core/coordinator.py - Pipeline coordinator → Judging explanations: generates reports
app/core/coordinator.py - Pipeline coordinator → Leaderboard ranking: ranks evaluations
app/core/coordinator.py - Pipeline coordinator → Calibration analysis: runs calibration
app/core/coordinator.py - Pipeline coordinator → Session files: persists sessions
app/core/coordinator.py - Reference analyzer → Semantic detector: uses detection
app/core/analyzers/reference.py - Participant analyzer → Semantic detector: uses detection
app/core/analyzers/participant.py - Reference analyzer → Profiles and results: builds profiles
app/core/analyzers/reference.py - Participant analyzer → Profiles and results: builds profiles
app/core/analyzers/participant.py - Feature comparator → Profiles and results: produces metrics
app/core/comparators/comparator.py - Weighted scoring → Profiles and results: produces scores
app/core/scoring/engine.py - Judging explanations → Profiles and results: produces reports
app/core/explanations/engine.py - Leaderboard ranking → Profiles and results: produces rankings
app/core/ranking/engine.py - Competition API → Competition results: returns results
README.md