Skip to content

README.md

Latest commit

 

History

History
189 lines (121 loc) · 4.74 KB

README.md

File metadata and controls

189 lines (121 loc) · 4.74 KB
Truth Sense Banner

🧠 TruthSense - AI-Powered News Verification Platform 🧠

Empowering people with truth, one article at a time.
A futuristic platform to verify, analyze, and understand the authenticity of the news you consume.

📖 Introduction

TruthSense is an AI-driven news verification platform built for the modern web. With misinformation spreading like wildfire, our platform uses state-of-the-art AI to detect whether the content you're reading is genuine or misleading. Whether it's a headline, full article, or just a URL—TruthSense gets to work.

🚀 Built for speed. ⚡ Powered by OpenAI. 💡 Designed for truth.

✨ Features

  • ✅ Verify headlines, full articles, or URLs using AI
  • 🤖 Smart classification: True / Fake / Unverified
  • 📊 Confidence scoring and model transparency
  • 🌍 Detects country of origin
  • 🧾 Maintains verification history
  • 💡 Smooth and responsive futuristic UI

🛠️ Tech Stack

🔹 Frontend

  • ⚛️ React.js
  • 💨 Tailwind CSS
  • 🔗 Axios for API calls
  • 🔔 React Toastify for toast notifications

🔹 Backend

  • ⚡ FastAPI (Python)
  • 🤯 OpenAI API integration
  • 🗃️ SQLite for database

🧪 Screenshot

UI Interface

Truth Sense Banner

🧰 Setup Instructions

Ensure you have Node.js, Python 3.8+, and a valid OpenAI API Key.

🔧 Backend Setup

📁 Step 1: Navigate to the backend directory

cd backend

🧪 Step 2: Create a virtual environment

python -m venv venv

🌀 Step 3: Activate the virtual environment

# On Windows:
venv\Scripts\activate

# On Linux/macOS:
source venv/bin/activate

📦 Step 4: Install Python dependencies

pip install -r requirements.txt

🔐 Step 5: Configure OpenAI API

# Create a .env file in the backend directory and add:
OPENAI_API_KEY=your_api_key_here

🚀 Step 6: Run the backend server

uvicorn main:app --reload

🎨 Frontend Setup

📁 Step 1: Navigate to the frontend directory

cd frontend

📦 Step 2: Install dependencies

npm install

🚀 Step 3: Start development server

npm run dev

🔗 The frontend will launch at http://localhost:3000

🚀 Usage

  1. 🔓 Open the app in your browser.
  2. ✍️ Enter a headline, full article text, or URL.
  3. 🔍 Click "Analyze News".
  4. 📋 Get real-time results: classification, confidence, source origin, and more.
  5. 🕓 Check your history anytime.

💡 Contributing

We welcome your ideas and improvements! Please fork the repo and submit a pull request 🚀

🔁 Fork and Clone

git clone https://github.com/Dev-axay18/Truth_Sense.git

🌿 Create a New Branch

git checkout -b feature-branch-name

💾 Stage and Commit Changes

git add .
git commit -m "Added new feature"

🚀 Push Changes

git push origin feature-branch-name

📥 Create Pull Request

Submit a PR from GitHub UI

📜 License

This project is licensed under the MIT License.

Made with ❤️ by Akshay Kale | Powered by AI