Skip to content

Repository files navigation

Glitch — the Aillucination mascot

Aillucination

The AI makes mistakes. Learn to see them.
An interactive daily quiz that teaches you to detect and fix AI hallucinations.

🌐 Play now → aillucination.com

Aillucination — Home screen

How It Works

Each daily mission walks you through 3 phases per question:

  1. 🔍 Detect — Read an AI response and identify what's wrong
  2. 🔧 Fix — Choose the prompt that avoids the hallucination
  3. 📊 Analyze — Understand why it works and get a takeaway tip

Complete your daily mission, build your streak, and share your mission report.

6 Categories of AI Errors

Category What It Means
👻 Factual Error The AI states something confidently wrong
📚 Source Fabrication The AI invents fake references or citations
💻 Code Hallucination The AI generates code with subtle bugs or fake APIs
🔄 Context Drift The AI loses track of the conversation context
🧠 Reasoning Error The AI makes flawed logical deductions
🪞 Manifest Incoherence The AI contradicts itself within the same response

Mission Report

After each mission, get a shareable report with your clearance level.

Aillucination — Mission report

Tech Stack

  • React 18 + Vite 5 — fast builds, modern DX
  • Vanilla CSS with CSS custom properties — lightweight, no framework overhead
  • Vercel — deployment and analytics

No backend. No auth. Pure static app with localStorage persistence.

Getting Started

# Install dependencies
npm install

# Start dev server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

The app runs at localhost:5173.

Contributing

We'd love your help — especially new scenarios! See CONTRIBUTING.md for guidelines.

# Validate scenarios before committing
python scripts/validate-scenarios.py

License

MIT

About

Interactive daily quiz to detect and fix AI hallucinations with shareable mission reports

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages