TruthGuard 360 is a modern, full-stack application designed to detect and flag fake news or misleading content. It uses a Machine Learning pipeline (TF-IDF + Logistic Regression) for text analysis, provides URL scraping capabilities, and includes a UI for audio/image metadata verification.
- Raw Text Analysis: Deep linguistic pattern analysis for pasted content.
- URL Analysis: Automatically scrapes news articles and checks source credibility.
- Audio Verification: Placeholder logic for analyzing transcribed audio clips.
- Visual Feedback: Real-time confidence scores and "Misinfo Score" indicators.
- Explainability: Identifies specific triggers (clickbait, sensationalism) used in the analysis.
- Python 3.8+
- Node.js 16+
- npm (Node Package Manager)
Navigate to the backend directory:
cd backend
Install dependencies: pip install -r requirements.txt
Train the Machine Learning model: python ml/train.py
Run migrations: python manage.py migrate
Start the Django server: python manage.py runserver
In a new terminal, navigate to the frontend directory:
cd frontend
Install dependencies: npm install
Start the development server: npm start
- Open http://localhost:3000 in your browser.
- Choose your input type: Raw Text, News URL, or Audio Clip.
- Enter the content you wish to verify.
- Example (Fake): "Shocking! Secret miracle water cures everything instantly!"
- Example (Real): "NASA rover finds evidence of ancient water on Mars surface"
- Click Perform Verification to see the results.
backend/api/: Django app handling requests and communication with the ML layer.backend/ml/: Machine learning logic, including training scripts and the predictor.frontend/src/: React application with Tailwind CSS styling and frontend components.
- CORS Errors: If the frontend cannot reach the backend, ensure
CORS_ALLOW_ALL_ORIGINSis set toTrueinbackend/truthguard/settings.py. - Model Missing: If you get a "Model not trained" error, make sure you ran
python ml/train.pyinside the backend directory. - Port Conflict: If port 8000 (Django) or 3000 (React) is busy, the apps might not start. Make sure no other services are running on those ports.