Skip to content

open source version of ground news with deeper discovery, diligence, and nuance. Verify publications, authors, conflict of interest, beyond major legacy media into indie journalists and beyond.

Notifications You must be signed in to change notification settings

andykeh710/unbiased-app

Repository files navigation

📰 Unbiased App

Unbiased App is an open-source news aggregation platform built to combat bias and improve media literacy. It leverages AI to provide transparency, neutrality, and context to news stories by analyzing sentiment, bias, and factual accuracy. The project is mobile-first and designed for everyone seeking a clearer view of the truth behind the headlines.

Features

  • News aggregation from diverse sources
  • AI analysis of articles including:
    • Political bias detection
    • Sentiment analysis
    • Neutral version generation
    • Fact claim extraction
  • Transparency cards for each article
  • Demo mode with pre-loaded articles

Demo Instructions

To explore the demo version of the application:

  1. The backend API server is running on port 5000
  2. The demo web interface can be accessed at:
    • /frontend/web/static.html

API Endpoints

Main Endpoints

  • GET /: Root endpoint with documentation and info
  • GET /api: API information
  • GET /api/articles: Get a list of articles
  • GET /api/articles/{article_id}: Get a specific article by ID
  • GET /api/articles/{article_id}/neutral: Get the neutral version of an article

Demo Endpoints

  • GET /api/demo/articles: Get a list of demo articles
  • GET /api/demo/articles/{article_id}: Get a specific demo article
  • GET /api/demo/articles/{article_id}/neutral-demo: Get the neutral version of a demo article
  • GET /api/demo/articles/{article_id}/analyze: Run AI analysis on a demo article

Technical Stack

  • Backend: Python with FastAPI
  • Database: PostgreSQL
  • AI Services: Implemented with demo versions for testing
  • Frontend (Web): Simple HTML/CSS/JavaScript
  • Frontend (Mobile): React Native (placeholder)

Demo Mode

The application includes a demo mode that doesn't require external API keys. It uses mock AI services to demonstrate the functionality of bias detection, neutral article generation, and other AI features.

✅ Current Features

  • News Aggregation: Pulls articles from multiple sources via a backend collector.
  • AI Analysis:
    • Political bias detection
    • Sentiment analysis
    • Entity extraction
    • Fact-checking and claim detection
    • Neutral version generation
  • Frontend (Next.js + Tailwind + ShadCN):
    • Home page with category filtering
    • Article view with original and neutral tabs
    • Chatbot interface with source citations and perspective summaries
    • User profile showing reading history, source balance, and saved content
    • Bookmarks and reading stats
    • Transparency cards showing bias, source reliability, sentiment, and verification status

🧭 What’s Missing / What’s Next

To reach our full vision, we need to build the following components:

🧠 Multi-Dimensional Bias System

Move beyond the traditional left-center-right spectrum. Introduce a multi-axis bias framework that captures:

  • Establishment vs. Anti-Establishment
  • Populist vs. Technocratic
  • Globalist vs. Nationalist
  • Optimistic vs. Alarmist

🧑‍💻 Author & Source History

Track and visualize how authors and media outlets evolve:

  • Author profiles with topic trends, average tone, and bias shifts
  • Source dashboards showing sentiment and reliability over time

🧠 Bias Clustering & Outlier Detection

Use clustering and anomaly detection to surface:

  • How an article fits or deviates from peer coverage on the same topic
  • Radar charts or visual clustering maps for major stories

🕰️ Narrative Timelines

Build visual timelines for story evolution, showing:

  • Shifts in sentiment, bias, and fact-checked claims over time
  • How coverage diverges between sources across a multi-day cycle

🕸️ Media Ownership & Network Graphs

  • Visualize source ownership and affiliations
  • Show editorial networks, corporate funding, and shared narratives

🔄 Feedback-Driven Learning

Create a system where users can:

  • Flag poor AI outputs
  • Suggest alternate interpretations
  • Feed this back into model fine-tuning or reinforcement loops

🧬 Meta-Sourcing Layer

  • Identify story originators, aggregators, and spinners
  • Show how narratives echo and mutate across the media ecosystem

🛠️ Next Steps (Development)

  • Update schema to support bias vectors and author/source history tracking
  • Integrate narrative timeline and outlier detection modules
  • Design and develop bias clustering and multi-dimensional analysis UI
  • Build interactive author/source history views
  • Add feedback collection system with hooks to AI models
  • Create visualization layer for media ownership and network analysis
  • Begin training on new bias dimensions using labeled datasets

We’re building a platform that doesn’t just show the news — it unpacks it. If you're interested in contributing, shaping our model, or joining the community, get in touch or start contributing.

About

open source version of ground news with deeper discovery, diligence, and nuance. Verify publications, authors, conflict of interest, beyond major legacy media into indie journalists and beyond.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published