Skip to content

Aliceeee14/The-Reality-Button

Repository files navigation

The Reality Button

A Chrome extension that lets you select any online claim and instantly receive a grounded credibility assessment.

What it does

The Reality Button analyzes text (headlines, social posts, claims) and returns:

  • Verdict (true / false / misleading / mixed / unclear)
  • Confidence score
  • Concise explanation
  • Supporting sources

Why I built this

Misinformation spreads faster than verification. Most people don’t fact-check because it’s too slow and inconvenient.

This project reduces that friction to one click.


How it works

Frontend

  • Chrome extension (popup UI + content script)
  • Users can paste or select text directly on a webpage

Backend

  • Node.js server deployed on Google Cloud Run

AI + Retrieval

  • Uses Google Gemini (2.5 Flash)
  • Enables live Google Search grounding
  • Extracts real sources from search results
  • Parses output into structured format

Architecture Chrome Extension → Cloud Run API → Gemini (with search grounding) → Structured response


Key design decisions

1. Grounded AI (not just LLM output)

The system uses live search instead of relying on model memory, which is critical for:

  • current events
  • political claims
  • fast-changing information

2. BYOK (Bring Your Own Key)

Users provide their own Gemini API key:

  • avoids centralized cost
  • scales without usage limits
  • mirrors real-world API products

3. Robust parsing over strict JSON generation

Instead of forcing fragile JSON from the model:

  • the system uses structured text
  • parses deterministically on the backend
  • improves reliability

Example

Input "Vaccines cause autism"

Output

  • Verdict: FALSE
  • Confidence: 95%
  • Explanation + sources (CDC, WHO)

How to run locally

1. Backend

cd Server
npm install
node server.js

2. Chrome extension

Go to chrome://extensions Enable Developer Mode Click "Load unpacked" Select project folder


Setup

In the extension:

  • Add your Gemini API key
  • Set server URL (local or Cloud Run)

Status

Working prototype. Actively improving:

  • confidence calibration
  • edge case handling
  • UI/UX polish

Future improvements

better confidence scoring claim clustering / repeated detection caching to reduce API calls highlighting which sources support which claim

About

The Reality Button is a Chrome extension that provides on-demand, AI-powered verification of selected text anywhere on the web. It sends the highlighted content through a private Node.js proxy to Google’s Gemini 2.5 Flash model, returning a grounded, concise assessment of factual accuracy with clear explanations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages