Skip to content

jessykiruba29/Diff-IQ

Repository files navigation

Diff-IQ 🧠🔍

AI-powered webpage change intelligence

Diff-IQ is a lightweight browser extension that tells you exactly what changed on a webpage since your last visit — even if it’s a single word.

No rereading.
No guessing.
Just clarity.


🚀 Features

  • Detects content changes between webpage visits
  • Generates precise, human-readable summaries of what changed
  • Accurately reports even one-word edits
  • Differentiates between minor updates and major content changes
  • AI-powered semantic understanding using Google Gemini
  • On-demand analysis (no background or automatic API calls)
  • Minimal, non-intrusive floating indicator
  • First-visit awareness and transparent behavior
  • Privacy-first: all page snapshots remain local

🧠 Why Diff-IQ?

Webpages evolve silently —
policies update, prices change, wording shifts, features appear or disappear.

Yet users are forced to reread entire pages just to answer one question:

“What actually changed?”

Diff-IQ was built to respect the user’s time and attention by surfacing only what matters.

Why reread everything when you only need to know what changed?


🧩 How It Works

  1. On the first visit to a webpage, Diff-IQ securely stores a snapshot of the page text locally
  2. On subsequent visits:
    • The current page content is compared with the stored snapshot
  3. When the user clicks the Diff-IQ indicator:
    • AI analyzes the differences semantically
    • A concise, human-readable change summary is generated
  4. AI is triggered only on user interaction — never automatically

No tracking.
No background scanning.
Full user control.


🛠️ Tech Stack

  • Platform: Chrome Extension (Manifest V3)
  • Language: Next JS
  • Storage: chrome.storage.local
  • AI / NLP: Google Gemini API (Gemini 2.5 Flash)
  • UI: Lightweight DOM-based UI (CSP-safe, non-intrusive)
  • Architecture: Event-driven, on-demand analysis

🧠 Step 1: Get a Google Gemini API Key

  1. Visit Google AI Studio
  2. Sign in with your Google account
  3. Generate a new API key
  4. Copy the API key (keep it private)

⚠️ Your API key is used only when you click the DiffIQ extension icon.
It is never sent or stored anywhere except your local browser.


🔑 Step 2: Add Your Gemini API Key

  1. Clone the repo and open the DiffIQ project folder in your code editor.

  2. Locate the file where the Gemini API key is defined.

  3. Find the following line:

    const GEMINI_API_KEY = null;

  4. Replace null with your API key as a string:

    const gemini_key = "YOUR_GEMINI_API_KEY_HERE";

  5. Save the file.

✅ DiffIQ is now ready to use AI-powered features.


🧩 Step 3: Load DiffIQ as a Chrome Extension (Developer Mode)

Since DiffIQ is a custom browser extension, it must be loaded manually.

Enable Developer Mode

  1. Open Google Chrome.

  2. Navigate to:

    chrome://extensions

  3. Enable Developer mode using the toggle in the top-right corner.


Load the Extension

  1. Click Load unpacked.
  2. Select the DiffIQ project root folder
    (the folder containing manifest.json).
  3. The DiffIQ extension will now appear in your extensions list.

📌 Optional: Pin DiffIQ to the toolbar for quick access.


🚀 Step 4: Using DiffIQ

  1. Open any webpage.
  2. Click the DiffIQ extension icon.
  3. On the first visit, DiffIQ stores a snapshot of the page.
  4. Revisit the page after the content changes.
  5. Click the icon again to view:
    • What changed
    • How it changed
    • A clear AI-generated summary

🔍 All analysis happens on demand — no background tracking and no automatic scans.


🔒 Privacy & Security Notes

  • The API key remains entirely local to the user's browser.
  • Page snapshots are stored using chrome.storage.local.
  • No data is shared, synced, or uploaded without user action.
  • AI requests are triggered only when the user clicks the extension.

✅ You're All Set!

DiffIQ is now installed and ready to turn silent webpage changes into clear, human-readable insights.

About

Diff-IQ is a lightweight browser extension that tells you exactly what changed on a webpage since your last visit.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors