Skip to content

mydemon21/cognitive-bias-detector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

๐Ÿง  Cognitive Bias Detector

License: MIT Version Chrome Web Store

A powerful browser extension that helps users identify and understand cognitive biases in online content. Enhance your critical thinking skills by automatically detecting biased language patterns in articles, social media posts, and other web content.

๐ŸŒŸ Features

๐ŸŽฏ Comprehensive Bias Detection

  • 12 Different Bias Types detected with high accuracy
  • Real-time Analysis of web page content
  • Context-aware Pattern Matching for precise detection
  • Color-coded Highlighting for easy identification

๐Ÿ“Š Analytics & Insights

  • Live Statistics showing bias counts on current page
  • Global Analytics across all visited sites
  • Top Sites Dashboard showing most biased websites
  • Historical Data tracking your browsing patterns

โš™๏ธ Customization Options

  • Toggle Individual Biases on/off
  • Multiple Highlight Styles (Enhanced, Underline, Background, Border)
  • Color Legend for bias type identification
  • Enable/Disable extension globally

๐Ÿ”’ Privacy-First Design

  • 100% Local Processing - no data sent to servers
  • No User Tracking or data collection
  • No Permissions beyond active tab access
  • Open Source and transparent

๐Ÿš€ Quick Start

Installation

Option 1: Chrome Web Store (Recommended)

Coming soon - extension under review

Option 2: Developer Mode

  1. Download or clone this repository

    git clone https://github.com/mydemon21/cognitive-bias-detector.git
  2. Open Chrome Extensions

    • Navigate to chrome://extensions/
    • Enable "Developer mode" (top-right toggle)
  3. Load Extension

    • Click "Load unpacked"
    • Select the cognitive-bias-detector folder
    • Extension will appear in your toolbar

First Use

  1. Click the extension icon in your browser toolbar
  2. Configure settings in the popup (all biases enabled by default)
  3. Visit any website and watch for highlighted biased content
  4. Hover over highlights to see bias explanations
  5. Check statistics in the extension popup

๐Ÿงฉ Detected Bias Types

Bias Type Description Example Patterns
๐Ÿ” Confirmation Bias Favoring information that confirms existing beliefs "This clearly proves...", "As we've always known..."
๐Ÿ’ญ Appeal to Emotion Using emotions instead of logical reasoning "This is terrifying...", "How would you feel if..."
โš–๏ธ False Dichotomy Presenting only two options when more exist "Either you're with us or against us"
๐Ÿ‘‘ Authority Bias Excessive weight to authority opinions "Experts say...", "According to authorities..."
๐Ÿ‘ Bandwagon Effect Adopting beliefs because others have "Everyone knows...", "Most people believe..."
๐ŸฅŠ Straw Man Fallacy Misrepresenting arguments to attack them "They claim that we should..."
๐Ÿ‘ค Ad Hominem Attack Attacking the person, not the argument "He's just an idiot...", "Don't trust them..."
๐ŸŒช๏ธ Spin Bias Using vague language to control narrative "Refused to comment...", "In a heated exchange..."
๐Ÿ“ฐ Sensationalism Exaggerated language for attention "BREAKING: Shocking revelation..."
๐ŸŽญ Subjective Qualifiers Loaded adjectives influencing interpretation "Disturbing trend...", "Serious allegations..."
๐Ÿ”ฎ Mind Reading Assuming others' thoughts without evidence "He thinks that...", "They want to..."
๐Ÿ”— Flawed Logic False correlations and connections "This happened because of that..."

๐Ÿ“ฑ Screenshots

Extension Popup Interface

Extension Popup The main extension popup showing bias detection statistics, settings, and color legend

Bias Detection in Action

Bias Detection Real-time bias detection highlighting different types of cognitive biases on web pages

Statistics Dashboard

Statistics Dashboard Comprehensive analytics showing bias detection across different websites and time periods

Settings & Configuration

Settings Configuration Customizable settings allowing users to toggle specific bias types and highlighting styles

๐Ÿ› ๏ธ Technical Details

Architecture

  • Manifest V3 Chrome extension
  • Content Script for page analysis
  • Service Worker for background processing
  • Local Storage for settings and statistics

Browser Compatibility

  • โœ… Chrome (Recommended)
  • โœ… Edge (Chromium-based)
  • โœ… Brave
  • โœ… Opera
  • โŒ Firefox (Manifest V2 version planned)

Performance

  • Lightweight - minimal impact on page load times
  • Efficient - processes only visible text content
  • Non-blocking - runs asynchronously
  • Memory-friendly - cleans up resources automatically

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

  1. Fork the repository
  2. Clone your fork locally
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

Reporting Issues

  • Use the GitHub Issues page
  • Include browser version and extension version
  • Provide steps to reproduce the issue
  • Include screenshots if applicable

๐Ÿ“„ License

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

๐Ÿ”’ Security

For security concerns, please see our Security Policy.

๐Ÿ“ˆ Changelog

See CHANGELOG.md for a detailed history of changes.

๐Ÿ™ Acknowledgments

  • Inspired by the need for better critical thinking tools online
  • Built with modern web extension APIs
  • Thanks to all contributors and testers

๐Ÿ“ž Support


Made with โค๏ธ for better critical thinking on the web

About

A browser extension that helps users identify cognitive biases in online content

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published