How amirmahdimtz/vision-similarity-service works
Vision Similarity Service is a FastAPI application that accepts two uploaded images and returns their cosine-similarity score. Its workflow validates upload metadata and size, extracts and normalizes a YOLO embedding for each image, then computes and returns the bounded score. Configuration and dependency injection support application startup and component construction. The README documents the YOLO embedding approach; unsampled configuration details and any additional runtime behavior are not inferred.
Main entry points: config_reader.py Config reader · image_similarity_controller.py Similarity controller · web.py Web service · yolo_embedding_provider.py YOLO embedding provider
Components 13
HTTP application
- Application host
src/host/app.py - Web service
src/application/web.py - Similarity controller
src/application/image_similarity/image_similarity_controller.py - Score response
src/application/image_similarity/dtos/image_similarity_dto.py
Similarity workflow
- Similarity calculation
src/core/services/image_similarity/image_similarity_service.py - YOLO embedding provider
src/infrastructure/ml/yolo_embedding_provider.py
Runtime infrastructure
- DI bootstrap
src/infrastructure/di/bootstrap.py - Dependency injection
src/infrastructure/di/inject.py
Configuration
- Config reader
src/infrastructure/utils/config_reader.py - Application settings
src/host/res/appsettings.development.yaml - Default settings
src/host/res/appsettings.yaml
Other components
- API client
- Ultralytics YOLO
Connections 14
- API client → Web service: sends requests
src/application/web.py - Application host → DI bootstrap: bootstraps DI
src/host/app.py - Application host → Web service: creates app
src/host/app.py - Web service → Config reader: reads settings
src/application/web.py - Web service → Similarity controller: discovers and routes
src/application/web.py - Similarity controller → Similarity calculation: compares images
src/application/image_similarity/image_similarity_controller.py - Similarity controller → Config reader: sets upload limit
src/application/image_similarity/image_similarity_controller.py - Similarity controller → Score response: returns score
src/application/image_similarity/image_similarity_controller.py - Similarity calculation → YOLO embedding provider: extracts embeddings
src/core/services/image_similarity/image_similarity_service.py - YOLO embedding provider → Ultralytics YOLO: extracts features
README.md - YOLO embedding provider → Config reader: reads model path
src/infrastructure/ml/yolo_embedding_provider.py - DI bootstrap → Dependency injection: loads modules
src/infrastructure/di/bootstrap.py - Application settings → Config reader: loads in development
src/infrastructure/utils/config_reader.py - Default settings → Config reader: loads otherwise
src/infrastructure/utils/config_reader.py