๐ŸŒ FactFlow

Empowering truth in the age of misinformation.
FactFlow helps users verify the authenticity of news, text, and images using AI, cross-referenced data, and trusted sources โ€” all in one sleek, intuitive platform.


๐Ÿš€ Overview

FactFlow is an AI-powered misinformation detection platform that enables users to upload text, news, or images and instantly receive verified sources, a Truth Index, and a detailed authenticity report.

Whether youโ€™re a journalist, researcher, or an everyday user โ€” FactFlow ensures what you read, share, and believe is rooted in fact.


๐Ÿง  Key Features

๐Ÿ” AI-Powered Fact Checking

  • Upload or paste any text or news article to detect potential misinformation.
  • Uses Google Fact Check API and AI-based text analysis to cross-verify claims.

๐Ÿงพ Truth Index

  • Generates a credibility score (0โ€“100) representing the factual accuracy of submitted content.

๐Ÿ–ผ๏ธ AI Image Verification

  • Analyze and verify images using AI vision models and metadata inspection.

๐ŸŽ™๏ธ Voice Assistant Integration

  • A built-in voice assistant for hands-free verification and quick summaries.

๐ŸŒ— Smart Toggle Mode

  • Switch between Fact Mode (AI verification) and Community Mode (social insights).
  • Toggle between Light/Dark Mode for better accessibility.

๐Ÿ’ฌ AI Chatbot Assistant

  • An interactive chatbot that helps users verify content, explain sources, and guide fact-checking processes.

๐Ÿ“ฐ Community Feed

  • Explore trending topics and recent verifications in domains like:
    • ๐Ÿฉบ Public Health
    • ๐Ÿ’ป Technology
    • ๐ŸŒ Global News
    • ๐Ÿ“ˆ Finance
    • ๐ŸŽฏ Politics
  • Contribute to discussions, rate verifications, and share credible information.

๐Ÿ‘ค User Profiles & Reputation

  • Each user has a FactFlow profile featuring:
    • ๐Ÿ… Badges: Truth Seeker, Verifier, Community Hero, Transporter, and more
    • ๐Ÿ“œ Verification History: See what youโ€™ve checked
    • โญ Reputation Points: Earn through accurate contributions and helpful feedback

๐ŸŒ Verified Source List

  • Every claim is linked to reliable outlets and fact-checking databases, ensuring transparency.

๐Ÿงฉ Future Enhancements

  • Integration with DBMS for scalable storage of user data and verification logs.
  • Multilingual support for global accessibility.
  • Mobile app version for Android and iOS.

๐Ÿงฐ Tech Stack

Layer Technology Used
๐ŸŽจ Design Figma โ€” for clean, intuitive, user-friendly UX/UI
๐Ÿ’ป Frontend React.js โ€” for fast, dynamic, component-based UI
โš™๏ธ Backend Node.js + Express.js โ€” for RESTful APIs & server logic
๐Ÿงฎ AI & APIs Google Fact Check API, Custom AI Models for Image & Text Verification
๐Ÿ’พ Future Database Planned DBMS Integration (MongoDB / PostgreSQL) for persistent storage
๐Ÿ—ฃ๏ธ Voice Processing Speech Recognition API for voice commands
๐Ÿ’ฌ Chatbot AI Assistant (OpenAI API / Similar Models)

๐Ÿงญ System Architecture

flowchart TD

A[User Input] -->|Text/News/Image/Voice| B[Frontend (React.js)]
B --> C[Backend (Node.js + Express.js)]
C --> D[Google Fact Check API]
C --> E[AI Verification Engine]
E --> F[Truth Index Calculator]
E --> G[AI Image Analyzer]
C --> H[Community & Profile Manager]
H --> I[Reputation + Badge System]
F --> J[Results Renderer (Frontend)]
G --> J
H --> J
J --> K[User Dashboard Display]
๐Ÿงช How It Works

Input: User uploads text, image, or speaks via the voice assistant.

Processing: Backend routes request to AI verification engine + Google Fact Check API.

Cross-Verification: Sources are matched, truth index is calculated, and AI summaries are generated.

Display: Results are shown on the dashboard with verified links, truth score, and AI explanation.

Engage: Users interact with the community, earn badges, and improve their reputation.

๐ŸŒ Core Values

Transparency: Every source is cited and verifiable.

Accuracy: AI + human input ensures credibility.

Community: Collective effort against misinformation.

Accessibility: Easy for anyone, anywhere, anytime.

๐Ÿ› ๏ธ Installation (Local Setup)
# Clone the repository
git clone https://github.com/your-username/factflow.git

# Move into project directory
cd factflow

# Install dependencies
npm install

# Run the development server
npm start


โš ๏ธ Note: Youโ€™ll need an API key for the Google Fact Check API and any additional AI models used for text/image verification.

๐Ÿง‘โ€๐Ÿ’ป Contributors
Name    Role    Contribution
Your Name
    Founder / Developer Core idea, frontend, backend, architecture
[Your Collaborators]    Designer / Dev  Figma UX/UI, API integration, testing
๐ŸŒŸ Badges & Recognition

FactFlow users can earn special community badges:

๐Ÿ… Truth Seeker โ€“ Verified 10+ claims

โšก Transporter โ€“ Shared 25+ credible verifications

๐Ÿง  Community Hero โ€“ Top-rated contributor

๐Ÿ”Ž Investigator โ€“ Reported high-impact misinformation

๐Ÿ’ก Future Roadmap

 Implement AI-powered summarizer for long news articles

 Add live misinformation alert system

 Launch mobile app version

 Gamified community leaderboards

 API access for developers

๐Ÿค Contributing

We welcome contributions!

Fork the repo

Create a feature branch (git checkout -b feature-name)

Commit changes (git commit -m 'Add feature-name')

Push to branch (git push origin feature-name)

Create a Pull Request ๐ŸŽ‰

Built With

Share this project:

Updates