Skip to content

TheChozenWon/DeepTruth

Repository files navigation

🔍 DeepTruth - AI-Powered Fact-Checking Platform

DeepTruth Logo

Unveiling Truth in the Digital Age

image

Frontend Link: https://github.com/jaydoshi2/Deeptruth-Frontend

Backend Link: https://github.com/jaydoshi2/Deeptruth-Backend

🌟 Overview

DeepTruth is an innovative fact-checking platform that combines the power of Google's Gemini AI and DistilBERT to provide real-time analysis of news articles and claims. Our Chrome extension makes it easy to verify information while browsing the web.

🎯 Key Features

  • Real-time Analysis: Instant fact-checking of any article title
  • Dual AI Model: Combines Gemini AI and DistilBERT for enhanced accuracy
  • Smart Weighting: 70% Gemini, 30% DistilBERT for optimal results
  • Chrome Extension: Seamless integration with your browsing experience
  • Detailed Reports: Comprehensive analysis with confidence scores
  • Source Verification: Cross-references multiple news sources

🛠️ Tech Stack

  • Frontend: React + Vite
  • Backend: Django + Django REST Framework
  • AI Models:
    • Google Gemini Pro
    • Fine-tuned DistilBERT
  • Database: MongoDB
  • Browser Extension: Chrome Extension API

🚀 Getting Started

Prerequisites

  • Python 3.8+
  • Node.js 16+
  • MongoDB
  • Chrome Browser
  • Google Gemini API Key

Backend Setup

  1. Clone the repository:
git clone https://github.com/yourusername/deeptruth.git
cd deeptruth/backend
  1. Create and activate virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Set up environment variables:
cp .env.example .env
# Edit .env with your API keys and settings
  1. Run migrations:
python manage.py makemigrations
python manage.py migrate
  1. Start the server:
python manage.py runserver

Frontend Setup

  1. Navigate to the Deeptruth directory:
cd ../Deeptruth
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev -- --host

Chrome Extension Setup

  1. Open Chrome and go to chrome://extensions/
  2. Enable "Developer mode"
  3. Click "Load unpacked" and select the Chrome Extension directory
  4. The DeepTruth icon should appear in your Chrome toolbar

🔧 Configuration

Environment Variables

Create a .env file in the backend directory with:

GEMINI_API_KEY=your_gemini_api_key
MONGODB_URI=your_mongodb_uri
DEBUG=True

📊 API Endpoints

  • POST /api/verify-claim/: Verify an article title
  • GET /api/false-news/: List all analyzed claims

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Google Gemini AI Team
  • Hugging Face for DistilBERT
  • Django and React communities
  • All contributors and supporters

📞 Support

For support, email support@deeptruth.com or join our Slack channel.


Made with ❤️ by the DeepTruth Team

© 2024 DeepTruth. All rights reserved.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •