A Chrome extension that automatically generates comprehension quizzes from any article using on-device AI. No internet required for AI processing—everything runs locally in your browser!

Side panel with quiz, crossword, and hangman features in light and dark mode

Interactive Quiz with Instant Feedback	AI-Generated Crossword Puzzle
Hangman Word Game	Personalized Learning Dashboard

• 📖 Smart Article Extraction - Automatically extracts main content from web pages using Mozilla's Readability library
• 📄 PDF Support - Extract text from PDF documents using Mozilla's PDF.js for quiz generation
• 🌐 Automatic Language Detection & Translation - Detects article language and translates non-English content to English for consistent AI processing
• 🤖 On-Device AI - Leverages Chrome's built-in AI APIs (no external API keys or internet required for AI)
  • AI Summarizer for concise article summaries
  • Language Model for quiz generation, crossword puzzles, and personalized suggestions
  • Language Detector for identifying article language
  • Translator for automatic translation to English
• 📝 Interactive Quizzes - Generates 20 multiple-choice questions based on article content
• ✅ Instant Feedback - Click answers to see if you're correct with visual feedback
• 🧩 Crossword Puzzles - AI-generated crossword puzzles from article content with interactive grid interface
• 🎯 Hangman Game - Word-guessing game using vocabulary from the article's crossword
• 🃏 Flashcards - Create flashcards from selected text for focused study
  • Right-click selected text and choose "Create Flashcard"
  • View and manage flashcards in the side panel
• 📊 Learning Dashboard - Personalized learning suggestions based on your quiz performance
  • Tracks answer history to identify knowledge gaps
  • Generates follow-up search suggestions
  • Provides category-specific recommendations
• 🔍 Omnibox Integration - Quick access to dashboard by typing "quizzer" in the address bar
• 🔔 Smart Notifications - Periodic updates with refreshed learning suggestions
• 🌓 Dark Mode Support - Automatic theme switching based on system preferences
• 🎨 Modern UI - Clean, GitHub-inspired design with smooth animations
• 🔒 Privacy-First - All AI processing happens on your device

• Chrome 129+ with AI features enabled
• Enable Chrome's AI features:
  1. Navigate to chrome://flags/#optimization-guide-on-device-model
  2. Set to "Enabled BypassPerfRequirement"
  3. Navigate to chrome://flags/#prompt-api-for-gemini-nano
  4. Set to "Enabled"
  5. Restart Chrome
  6. Confirm AI models are available at chrome://components/ (look for "Optimization Guide On Device Model")

1. Clone this repository:

   git clone https://github.com/edvilme/chrome-quizzer.git
   cd chrome-quizzer

2. Install dependencies and build:

   npm install
   npm run build

3. Load the extension in Chrome:

   • Open chrome://extensions in Chrome
   • Enable "Developer mode" (top-right toggle)
   • Click "Load unpacked"
   • Select the chrome-quizzer folder

4. The extension icon will appear in your toolbar. Click it to open the side panel!

1. Navigate to any article or PDF on the web (blog posts, news articles, documentation, PDF files, etc.) in any language
2. Click the Chrome Quizzer icon in your toolbar to open the side panel
3. Wait for processing - The extension will:
   • Extract the article content
   • Detect the article's language (displayed in the UI)
   • Automatically translate non-English content to English
   • Generate a summary
   • Create 20 quiz questions
   • Generate a crossword puzzle
   • Create a hangman game
4. Take the quiz - Click on answers to test your comprehension
5. Get instant feedback - Correct answers turn green, incorrect ones turn red
6. Play crossword - Fill in the interactive crossword puzzle based on article content
7. Play hangman - Guess letters to reveal words from the article

1. Access the dashboard by:
   • Clicking "Open Dashboard" button in the side panel, or
   • Typing quizzer in Chrome's address bar (omnibox) and pressing Enter
2. View personalized suggestions based on your quiz performance
3. Click follow-up searches to explore topics where you need improvement
4. Track your progress across different knowledge categories

Your quiz answers are tracked locally to provide personalized learning suggestions. The extension periodically refreshes suggestions and sends notifications with updates.

chrome-quizzer/
├── assets/           # Extension icons and screenshots
├── schemas/          # JSON schemas for AI responses
│   ├── quiz-schema.json
│   ├── crossword-schema.json
│   ├── dashboard-category-schema.json
│   └── answer-schema.json
├── src/              # Source code
│   ├── service_worker.js      # Background script (AI processing)
│   ├── pdf_extractor.js       # PDF text extraction using PDF.js
│   ├── LanguageModel.js       # Quiz, crossword, and suggestion generation
│   ├── Summarizer.js          # Article summarization
│   ├── TabExtractor.js        # Content extraction (HTML & PDF)
│   ├── LanguageDetector.js    # Language detection
│   └── ModelAcquisition.js    # AI model management
├── static/           # UI components
│   ├── sidepanel/             # Side panel UI
│   ├── dashboard/             # Learning dashboard
│   ├── QuestionComponent/     # Quiz question component
│   ├── CrossWordComponent/    # Crossword puzzle component
│   └── HangmanComponent/      # Hangman game component
├── manifest.json     # Extension configuration
└── package.json      # Dependencies

npm run build

This bundles both the service worker and PDF extractor with esbuild:

• dist/service_worker.js - Main extension background script
• dist/pdf_extractor.js - PDF text extraction module (injected when needed)

• Service Worker: Check chrome://serviceworker-internals or the extensions page for console logs
• Side Panel: Right-click the side panel → "Inspect" to open DevTools

• Chrome Extension APIs: Manifest V3, Side Panel API, Scripting API, Omnibox API, Notifications API, Storage API, Search API
• Chrome AI APIs: Built-in Language Model, Summarizer, Language Detector, and Translator
• Mozilla Readability: Article content extraction
• Mozilla PDF.js: PDF text extraction
• linkedom: Server-side DOM parsing
• crossword-layout-generator: Crossword puzzle layout generation
• esbuild: Fast bundling

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

Contributions are welcome! Feel free to open issues or submit pull requests.

• Only works on pages with readable article content or PDF documents
• Requires Chrome's experimental AI features to be enabled
• AI models need to be downloaded on first use (may take a few minutes)
• Quiz quality depends on article content and AI model capabilities
• Non-English articles are automatically translated to English, which may affect nuance and context in quiz generation
• PDF text extraction may not work perfectly with complex layouts, scanned documents, or image-based PDFs