How baggie11/virtual-photobooth works
Virtual Photo Booth is a Vue photo-capture/upload client backed by a FastAPI neural-style-transfer service. The principal flow is browser capture or upload, API validation and image preprocessing, selectable ONNX/PyTorch inference, then a saved stylized image returned to the client. The graph also preserves the health endpoint, model architecture, configuration, and structured logging. Frontend-to-API behavior is based on README documentation; source excerpts do not show the Vue request implementation or all route details.
Main entry points: factory.py Engine Factory · style_transfer_service.py Transfer Service · style_transfer.py Transfer Endpoint · main.py FastAPI App
Components 24
Photo Booth UI
- Capture & Upload
frontend/src/components/PhotoPage.vue - Landing Page
frontend/src/components/LandingPage.vue - Client Routes
frontend/src/router/index.js - Vue App Mount
frontend/src/main.js
API Service
- FastAPI App
backend/app/main.py - API Router
backend/app/api/router.py - Transfer Endpoint
backend/app/api/routes/style_transfer.py - Health Endpoint
backend/app/api/routes/health.py - API Schemas
backend/app/schemas/requests.py - Response Schemas
backend/app/schemas/responses.py - Transfer Service
backend/app/services/style_transfer_service.py - Upload Validation
backend/app/utils/file_validation.py - Image Processing
backend/app/utils/image_processing.py - Upload & Result Files
backend/app/services/style_transfer_service.py
Inference Runtime
- Engine Factory
backend/app/inference/factory.py - ONNX Engine
backend/app/inference/onnx_engine.py - PyTorch Engine
backend/app/inference/pytorch_engine.py
Neural Model
- Transformer Network
backend/app/models/transformer_net.py - Convolution Block
backend/app/models/conv_block.py - Residual Block
backend/app/models/residual_block.py - Checkpoint Loader
backend/app/models/checkpoint.py
Configuration & Observability
- Runtime Settings
backend/app/core/config.py - JSON Logging
backend/app/core/logging.py
Other components
- User Browser
Connections 27
- User Browser → Capture & Upload: captures or uploads
README.md - Capture & Upload → Transfer Endpoint: submits image
README.md - Vue App Mount → Client Routes: mounts routes
frontend/src/main.js - Client Routes → Landing Page: routes to
frontend/src/router/index.js - Client Routes → Capture & Upload: routes to
frontend/src/router/index.js - FastAPI App → API Router: registers
backend/app/main.py - API Router → Health Endpoint: includes
backend/app/api/router.py - API Router → Transfer Endpoint: includes
backend/app/api/router.py - Transfer Endpoint → Transfer Service: calls
backend/app/api/routes/style_transfer.py - Transfer Endpoint → API Schemas: uses request
backend/app/api/routes/style_transfer.py - Transfer Endpoint → Response Schemas: uses response
backend/app/api/routes/style_transfer.py - Health Endpoint → Response Schemas: uses response
backend/app/api/routes/health.py - Transfer Service → Upload Validation: validates upload
backend/app/services/style_transfer_service.py - Transfer Service → Image Processing: preprocesses image
backend/app/services/style_transfer_service.py - Transfer Service → Upload & Result Files: writes images
README.md - Transfer Service → Engine Factory: runs configured engine
- FastAPI App → Engine Factory: builds engine
backend/app/main.py - Engine Factory → ONNX Engine: selects backend
backend/app/inference/factory.py - Engine Factory → PyTorch Engine: selects backend
backend/app/inference/factory.py - PyTorch Engine → Transformer Network: runs model
backend/app/inference/pytorch_engine.py - PyTorch Engine → Checkpoint Loader: loads weights
backend/app/inference/pytorch_engine.py - Transformer Network → Convolution Block: uses blocks
backend/app/models/transformer_net.py - Transformer Network → Residual Block: uses blocks
backend/app/models/transformer_net.py - FastAPI App → Runtime Settings: loads settings
backend/app/main.py - Engine Factory → Runtime Settings: selects engine paths
backend/app/inference/factory.py - FastAPI App → JSON Logging: configures logging
backend/app/main.py - Engine Factory → JSON Logging: logs engine setup
backend/app/inference/factory.py