How giharanavindu/truthbomb works
TruthBomb is a multilingual, local-first social-media fact-checking application. A user submits a post in the React interface; the FastAPI boundary runs a LangGraph workflow that extracts a normalized claim, retrieves local evidence, routes research locally or to trusted web search, adjudicates findings, and translates the result. The interface presents the verdict, sources, and a live-news ticker. Separate ingestion workers keep the local OSINT corpus current. The graph reflects documented calls and README capabilities; some unsampled internals and the precise connection of synthesis to the runtime are not established by the excerpts.
Main entry points: pipeline.py State workflow · App.tsx Application UI · web_researcher.py Web research · main.py FastAPI service
Components 25
User Interface
- Application UI
frontend/src/App.tsx - Claim form
frontend/src/components/FactCheckerForm.tsx - News ticker
frontend/src/components/LatestNewsTicker.tsx - Verdict card
frontend/src/components/ResultCard.tsx - Context sources
frontend/src/components/ContextSources.tsx
API and Workflow
- FastAPI service
src/main.py - State workflow
src/pipeline.py - Agent state
src/state.py
Research and Verification
- Claim extraction
src/agents/claim_extractor.py - Retrieval node
src/agents/retriever.py - Local research
src/agents/local_researcher.py - Web research
src/agents/web_researcher.py - Adjudication
src/agents/adjudicator.py - Verdict synthesis
src/agents/synthesis.py - Translation
src/agents/translator.py
Evidence and Ingestion
- Hybrid retrieval
src/tools/hybrid_retriever.py - RAG retriever
src/rag/retriever.py - Rank fusion
src/rag/fusion.py - Local DB verifier
src/tools/local_db_tool.py - Chroma store
src/tools/local_db_tool.py - Trusted web search
src/tools/web_search_tool.py
Language Models
- GGUF extractor
src/models/extractor.py
Other components
- Fact-check user
- Telegram and RSS
- Gemini service
Connections 28
- Fact-check user → Claim form: enters claim
- Claim form → Application UI: submits text
frontend/src/App.tsx - Application UI → FastAPI service: posts verification
frontend/src/App.tsx - FastAPI service → State workflow: runs graph
src/main.py - State workflow → Claim extraction: starts extraction
src/pipeline.py - State workflow → Retrieval node: dispatches retrieval
src/pipeline.py - State workflow → Local research: routes locally
src/pipeline.py - State workflow → Web research: routes to web
src/pipeline.py - State workflow → Adjudication: dispatches findings
src/pipeline.py - State workflow → Translation: translates verdict
src/pipeline.py - Claim extraction → GGUF extractor: extracts claim
src/agents/claim_extractor.py - Retrieval node → Hybrid retrieval: retrieves evidence
src/agents/retriever.py - Local research → Local DB verifier: verifies locally
src/agents/local_researcher.py - Local research → Web research: falls back
src/agents/local_researcher.py - Web research → Trusted web search: searches web
src/agents/web_researcher.py - Hybrid retrieval → Chroma store: queries dense store
src/tools/hybrid_retriever.py - Hybrid retrieval → RAG retriever: uses retrieval
- RAG retriever → Rank fusion: fuses rankings
src/rag/retriever.py - Local DB verifier → RAG retriever: retrieves context
src/tools/local_db_tool.py - Local DB verifier → Chroma store: reads documents
src/tools/local_db_tool.py - Telegram and RSS → Chroma store: feeds corpus
- GGUF extractor → Gemini service: uses fallback
src/models/extractor.py - Web research → Gemini service: requests verdict
src/agents/web_researcher.py - Application UI → News ticker: renders ticker
frontend/src/App.tsx - Application UI → Verdict card: renders verdict
frontend/src/App.tsx - Application UI → Context sources: renders sources
frontend/src/App.tsx - FastAPI service → Application UI: returns response
- Adjudication → Verdict synthesis: may synthesize