How renzkirby/truthlens works
TruthLens combines a browser extension, web community, and Django service for evidence-first misinformation verification. The primary workflow takes text, URLs, images, or documents through input processing, claim matching, internal knowledge lookup, external evidence retrieval, and evidence-grounded analysis; uncertain claims can enter collaborative review. The web platform also supports community discussions, moderation, organization workspaces, and publication. Edges reflect README-documented flows or source-index references; unsampled implementations are represented only at supported directory paths.
Main entry points: models.py Domain records · App.jsx Web platform · evidence_review_service.py Evidence review · publication_workflow_query_service.py Publication workflow
Components 27
User clients
- Browser extension
extension/src/App.jsx - Web platform
frontend/frontend/src/App.jsx - API client
frontend/frontend/src/utils/api.js
Verification pipeline
- Input processing
backend/truthlens_backend/api/ocr_service.py - Claim matching
backend/truthlens_backend/api/claim_matching.py - Knowledge reuse
backend/truthlens_backend/api/knowledge_reuse_service.py - Evidence retrieval
backend/truthlens_backend/api/verification - AI analysis
backend/truthlens_backend/api/verification_intelligence_service.py
Community review
- Community feed
frontend/frontend/src/Pages/CommunityFeed.jsx - Threads and evidence
frontend/frontend/src/Pages/ThreadDetailPage.jsx - Evidence review
backend/truthlens_backend/api/evidence_review_service.py - Moderation
backend/truthlens_backend/api/moderation_service.py - Trust scores
backend/truthlens_backend/api/trust_service.py - Verification assignment
backend/truthlens_backend/api/verification_assignment_service.py
Organizations and publishing
- Organization workspace
frontend/frontend/src/Pages/WorkspacePage.jsx - Organization services
backend/truthlens_backend/api/organization_service.py - Publication workflow
backend/truthlens_backend/api/publication_workflow_query_service.py - Publishing
backend/truthlens_backend/api/publishing_service.py - Factual corrections
backend/truthlens_backend/api/factual_correction_query_service.py - Accountability
backend/truthlens_backend/api/accountability_service.py
Shared backend
- Backend API
backend/truthlens_backend/api/views.py - Domain records
backend/truthlens_backend/api/models.py - Evidence snapshots
backend/truthlens_backend/api/evidence_snapshot_schema.py - Publication snapshots
backend/truthlens_backend/api/publication_snapshot_schema.py - Background tasks
backend/truthlens_backend/api/tasks.py
Other components
- Browser user
- Web user
Connections 28
- Browser user → Browser extension: submits content
- Browser extension → Backend API: requests verification
- Web user → Web platform: uses platform
- Web platform → API client: calls API
frontend/frontend/src/App.jsx - API client → Backend API: sends requests
- Backend API → Input processing: processes inputs
- Input processing → Claim matching: matches claims
- Claim matching → Knowledge reuse: checks knowledge
- Knowledge reuse → Evidence retrieval: retrieves evidence
- Evidence retrieval → AI analysis: grounds analysis
- AI analysis → Threads and evidence: escalates uncertain claims
- Web platform → Community feed: routes to feed
frontend/frontend/src/App.jsx - Web platform → Threads and evidence: routes to threads
frontend/frontend/src/App.jsx - Threads and evidence → Evidence review: submits evidence
- Evidence review → Domain records: reads and writes
backend/truthlens_backend/api/evidence_review_service.py - Evidence review → Moderation: uses moderation
backend/truthlens_backend/api/evidence_review_service.py - Evidence review → Verification assignment: uses assignments
backend/truthlens_backend/api/evidence_review_service.py - Evidence review → Trust scores: updates reputation
backend/truthlens_backend/api/evidence_review_service.py - Web platform → Organization workspace: routes to workspace
frontend/frontend/src/App.jsx - Organization workspace → Publication workflow: manages publication work
- Publication workflow → Organization services: checks capabilities
backend/truthlens_backend/api/publication_workflow_query_service.py - Publication workflow → Domain records: reads records
backend/truthlens_backend/api/publication_workflow_query_service.py - Publication workflow → Evidence snapshots: validates snapshots
backend/truthlens_backend/api/publication_workflow_query_service.py - Publishing → Domain records: writes records
- Factual corrections → Domain records: reads records
backend/truthlens_backend/api/factual_correction_query_service.py - Accountability → Domain records: uses records
- Domain records → Publication snapshots: validates publication data
backend/truthlens_backend/api/models.py - Backend API → Background tasks: dispatches work