How ashishgajare/face-id-blockchain-verification works
TraceFace accepts an image through its Streamlit UI or CLI, detects and embeds a face, searches for visually similar images, filters social candidates, and compares candidate faces against a similarity threshold. A verified match becomes a canonical verification record whose SHA-256 hash is submitted to Polygon Amoy and checked on-chain. The graph preserves the distinct discovery, comparison, record, and anchoring stages. Evidence is limited to the supplied excerpts and source index; unsampled subsystem details and some UI wiring are therefore not expanded.
Main entry points: pipeline.py Verification Pipeline · serpapi_client.py Reverse Image Search · contract.py Contract Client · client.py Polygon Client
Components 21
User Interfaces
- Streamlit Studio
face-blockchain-verification/ui/app.py - CLI
face-blockchain-verification/main.py - Verification Pipeline
face-blockchain-verification/verification/pipeline.py - Runtime Config
face-blockchain-verification/config.py
Face Analysis
- Face Detector
face-blockchain-verification/face/detector.py - Embedding Tools
face-blockchain-verification/face/embedding.py - Similarity Gate
face-blockchain-verification/face/similarity.py
Search Discovery
- Reverse Image Search
face-blockchain-verification/reverse_search/serpapi_client.py - Search Result Parser
face-blockchain-verification/reverse_search/result_parser.py - Social Candidate Filter
face-blockchain-verification/reverse_search/social_filter.py
Verification Records
- Record Model
face-blockchain-verification/verification/models.py - Record Hashing
face-blockchain-verification/verification/hashing.py
Blockchain Anchoring
- Polygon Client
face-blockchain-verification/blockchain/client.py - Contract Client
face-blockchain-verification/blockchain/contract.py - Verification Contract
contracts/FaceVerification.sol - Blockchain Record Helpers
face-blockchain-verification/blockchain/record.py
Other components
- Image Submitter
- SerpApi
- Temporary Image Host
- Candidate Image Sites
- Polygon Amoy RPC
Connections 22
- Image Submitter → Streamlit Studio: uploads image
face-blockchain-verification/ui/app.py - Image Submitter → CLI: provides image
face-blockchain-verification/main.py - Streamlit Studio → Verification Pipeline: runs verification
face-blockchain-verification/ui/app.py - CLI → Verification Pipeline: runs verification
face-blockchain-verification/main.py - Verification Pipeline → Runtime Config: reads settings
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Face Detector: detects faces
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Embedding Tools: normalizes vectors
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Reverse Image Search: searches image
face-blockchain-verification/verification/pipeline.py - Reverse Image Search → Temporary Image Host: uploads image
face-blockchain-verification/reverse_search/serpapi_client.py - Reverse Image Search → SerpApi: requests results
face-blockchain-verification/reverse_search/serpapi_client.py - Verification Pipeline → Search Result Parser: parses results
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Social Candidate Filter: filters candidates
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Candidate Image Sites: downloads images
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Similarity Gate: compares faces
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Record Model: builds record
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Record Hashing: hashes record
face-blockchain-verification/verification/pipeline.py - Record Hashing → Record Model: serializes model
face-blockchain-verification/verification/hashing.py - Verification Pipeline → Polygon Client: connects client
face-blockchain-verification/verification/pipeline.py - Verification Pipeline → Contract Client: stores and checks
face-blockchain-verification/verification/pipeline.py - Contract Client → Polygon Client: sends transactions
face-blockchain-verification/blockchain/contract.py - Polygon Client → Polygon Amoy RPC: uses RPC
face-blockchain-verification/blockchain/client.py - Contract Client → Verification Contract: calls contract
face-blockchain-verification/blockchain/contract.py