CDE90/BathHack2025

Bath Hack 2025 Best Use of AI Winner - The Credibility Compass

โ˜… 0Forks 0TypeScriptGitHub โ†—Compare

README

The Credibility Compass

A news credibility analysis tool developed for Bath Hack 2025 that evaluates news articles for factual accuracy, political bias, source reliability, and sentiment.

๐ŸŒŸ Inspiration

In an era of information overload and increasing concerns about misinformation, we were inspired to create a tool that helps people navigate the complex media landscape. The Credibility Compass was born from our desire to empower readers with AI-assisted insights into the credibility and bias of the news they consume.

Our goal was to build a solution that:

  • Promotes media literacy and critical thinking
  • Provides transparent assessments of news content
  • Helps users recognize political bias and sentiment in reporting
  • Reduces the spread of misinformation by highlighting factual inaccuracies

๐Ÿ” What It Does

The Credibility Compass allows users to:

  1. Enter any news article URL for comprehensive analysis
  2. View factuality assessments with confidence scores, ratings, and supporting sources
  3. Understand the reliability of the news source with detailed reasoning
  4. Identify political leaning of both the article and its source on a spectrum from Far Left to Far Right
  5. Analyze sentiment patterns throughout the article, with entity-specific sentiment highlighting

๐Ÿ› ๏ธ How We Built It

This project is built with a modern web stack:

  • Frontend: Next.js with the App Router, Tailwind CSS, and shadcn/ui components
  • Backend: Next.js API routes handling content processing and analysis
  • AI Integration:
    • Google's Gemini API for comprehensive content analysis
    • Perplexity API for search-based factual verification and source credibility assessment
  • Data Processing: Custom algorithms for entity extraction, sentiment analysis, and bias detection

๐Ÿง  Challenges We Faced

Building The Credibility Compass came with several challenges:

  • Content Extraction: Developing robust methods to extract clean article text from diverse news websites
  • Bias Detection: Creating a nuanced system for identifying political bias without introducing our own biases
  • Performance Optimization: Balancing comprehensive analysis with reasonable response times
  • Source Credibility: Establishing reliable metrics to evaluate the trustworthiness of news sources
  • UI/UX Design: Creating an intuitive interface that presents complex information clearly

๐Ÿ† Accomplishments

We're proud of creating:

  • A fully functional tool that provides multi-faceted analysis of news content
  • An intuitive user interface that makes complex information accessible
  • A system that balances detailed analysis with user-friendly presentation
  • Integration with advanced AI models to provide sophisticated insights

๐Ÿ“š What We Learned

Through this project, we gained expertise in:

  • Prompt engineering for specialized AI analysis
  • Content extraction techniques for web articles
  • Political bias detection methodologies
  • Sentiment analysis implementation
  • Building responsive UIs for data-heavy applications
  • Optimizing API calls to external AI services

๐Ÿ”ฎ What's Next

Future enhancements we're considering:

  • Browser extension for instant analysis while browsing
  • Expanded historical context for news sources
  • Comparison feature to analyze multiple articles on the same topic
  • Community feedback integration to improve analysis accuracy
  • Mobile application development

๐Ÿš€ Getting Started

Installation

# Clone the repository
git clone https://github.com/CDE90/BathHack2025.git
cd BathHack2025

# Install dependencies
pnpm install

Development

# Start the development server
pnpm dev

Building for Production

# Build the application
pnpm build

# Start the production server
pnpm start

๐Ÿงช Testing and Quality Assurance

# Run linting
pnpm lint

# Fix linting issues
pnpm lint:fix

# Run type checking
pnpm typecheck

# Check formatting
pnpm format:check

# Fix formatting
pnpm format:write

๐Ÿ‘ฅ Contributors

๐Ÿ“„ License

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

Contributors

CDE90tomdartmoor

Issues