How regullar/shynai works
ShynAI is a Chrome-based fact-checking product: users check selected claims or scan an article, then inspect a structured verdict and auditable evidence. The extension sends requests to a FastAPI backend, which searches its Russian/Kazakh corpus and can use live search when local evidence is inadequate; evidence is quote-checked before a decisive result is returned. The extension also supports framing analysis, evidence-bounded chat, report highlights, export, and local history. Arrows are limited to README-documented flows and relationships shown in sampled source references; unsampled internals are not expanded.
Main entry points: main.py API routes · App.tsx Side panel · api.ts API client · ResultView.tsx Verdict and evidence
Components 20
Browser extension
- Page extraction
apps/extension/src/content.ts - Extension background
apps/extension/src/background.ts - Side panel
apps/extension/src/sidepanel/App.tsx - API client
apps/extension/src/lib/api.ts - Local preferences
apps/extension/src/lib/storage.ts - Verdict and evidence
apps/extension/src/sidepanel/components/ResultView.tsx - Page audit
apps/extension/src/sidepanel/components/PageAuditView.tsx - Local history
apps/extension/src/sidepanel/components/HistoryPanel.tsx
Fact-check backend
- API routes
apps/backend/app/main.py - Request schemas
apps/backend/app/schemas.py - Corpus retrieval
apps/backend/app/services/retrieval.py - Verdict verification
apps/backend/app/services/verifier.py - Safe source fetch
apps/backend/app/services/scraper.py - Scan reports
apps/backend/app/services/report_store.py
Evidence sources
- Local corpus
data/chunks.jsonl - AI search and models
User support features
- Evidence-bounded chat
apps/backend/app/services/chat.py - Framing analysis
apps/extension/src/sidepanel/components/CognitiveBiasRadar.tsx
Other components
- Reader
- Article page
Connections 27
- Reader → Side panel: requests check
README.md - Article page → Page extraction: provides text
README.md - Page extraction → Side panel: sends selection
- Reader → Side panel: starts page scan
README.md - Side panel → API client: calls
apps/extension/src/sidepanel/App.tsx - Extension background → API client: calls
apps/extension/src/background.ts - Extension background → Local preferences: reads and writes
apps/extension/src/background.ts - Side panel → Local preferences: reads and writes
apps/extension/src/sidepanel/App.tsx - API client → API routes: HTTP requests
README.md - API routes → Request schemas: uses schemas
apps/backend/app/main.py - API routes → Corpus retrieval: retrieves evidence
apps/backend/app/main.py - Corpus retrieval → Local corpus: searches chunks
README.md - API routes → Verdict verification: verifies claim
apps/backend/app/main.py - Verdict verification → Corpus retrieval: uses local context
apps/backend/app/services/verifier.py - Verdict verification → AI search and models: queries models
apps/backend/app/services/verifier.py - Verdict verification → Safe source fetch: validates live quote
apps/backend/app/services/verifier.py - Safe source fetch → Article page: fetches public source
- API routes → Scan reports: stores scan report
apps/backend/app/main.py - API client → Scan reports: fetches report
README.md - API routes → Evidence-bounded chat: handles chat
apps/backend/app/main.py - Evidence-bounded chat → AI search and models: generates answer
- API routes → API client: returns result
README.md - Side panel → Page audit: renders scan
apps/extension/src/sidepanel/App.tsx - Side panel → Verdict and evidence: renders verdict
apps/extension/src/sidepanel/App.tsx - Verdict and evidence → Framing analysis: shows analysis
apps/extension/src/sidepanel/components/ResultView.tsx - Verdict and evidence → Evidence-bounded chat: asks evidence questions
- Verdict and evidence → Local history: records result