Hist'Bunked

Hist'Bunked is an AI-powered historical fact-checking platform designed to combat misinformation by verifying claims through a multi-layered approach.

🚀 Project Overview

In the digital age, historical myths and misinformation spread rapidly. Hist'Bunked provides a reliable tool to distinguish fact from fiction using advanced AI and real-time web search.

Key Features

• Reliability Check: Cross-references claims with trusted academic sources and encyclopedias using DuckDuckGo Search.
• Logic Analysis: Uses Google Gemini 2.0 Flash to detect anachronisms and logical impossibilities (e.g., checking if a technology existed or a person was alive).
• Plausibility Assessment: Analyzes historical context, culture, and causality to determine the likelihood of an event.
• Chrome Extension: Allows users to verify claims directly from their browser.

🛠️ Tech Stack

• Backend: Python, FastAPI, Uvicorn
• AI Logic: Google Gemini 2.0 Flash
• Search: DuckDuckGo Search (ddgs)
• Frontend: HTML5, CSS3 (Custom "Sepia" Theme), Vanilla JavaScript
• Extension: Chrome Manifest V3

📦 Installation & Setup

1. Clone the repository:

   git clone https://github.com/yourusername/histbunked.git
   cd histbunked

2. Install Dependencies:

   pip install -r backend/requirements.txt

3. Run the Backend:

   cd backend
   uvicorn main:app --reload

4. Access the Web Interface: Open http://localhost:8000/ui/index.html in your browser.

5. Load the Extension:

   • Open Chrome and go to chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked" and select the frontend/extension folder.

👥 Team

Built for the 2025 Hackathon. We believe in the power of technology to preserve the truth.