AnkiQuiz

Transform passive flashcard review into active, exam-style practice — automatically.

OVERVIEW

AnkiQuiz is an Anki add-on that bridges the gap between memorization and application. While Anki is excellent for building memory, it does not train you to apply concepts under exam conditions. This add-on solves that by turning the cards you just reviewed into AAMC-style multiple-choice quizzes — without any extra effort on your part.

Although it works with any deck, AnkiQuiz was built specifically with the MCAT in mind, following AAMC-style logic to help you recognize patterns, avoid common traps, and think through questions the way you will need to on exam day.

HOW IT HELPS

• Reinforces concepts through application, not just recall
• Trains you to recognize how material appears in real exam questions
• Surfaces weak areas and reasoning mistakes while you study
• Builds test-taking skills alongside content knowledge — at the same time

Questions are intentionally structured around AAMC-style logic — designed to make your brain think in the format and reasoning of real test questions.

HOW IT WORKS

• Review your Anki cards as normal — no change to your workflow
• After every N cards (default: 20, fully adjustable), a quiz pop-up appears
• The quiz is built from the exact concepts you just reviewed that session
• Answer, review, learn — then get back to your cards

EACH QUIZ INCLUDES

• Multiple-choice questions (A–D) styled after AAMC clinical vignettes
• Correct answer explanations and high-yield key takeaways
• A full end-of-quiz review showing every question, your answer, and the correct one
• Confidence ratings so you can see the difference between knowing and guessing

KEY FEATURES

• Auto-generation — quiz fires automatically every N answered cards (default 20, fully adjustable)
• MCAT-quality questions — application and reasoning, not recall; clinical vignettes with plausible distractors
• Adaptive difficulty — automatically shifts between Foundational / Standard / Challenging based on your recent performance
• Full answer review — after every quiz, review all questions with correct answers, explanations, and your confidence ratings
• Back-navigation — revisit any question before submitting; clickable Q-number bar (🟢 correct, 🔴 wrong)
• Confidence rating — rate each answer (Confident / Unsure / Guessed) to map your true mastery
• Missed & fragile concept tracking — missed questions are logged locally; concepts move through Weak → Fragile → Resolved as you improve
• Retry quizzes — re-test missed questions or fragile concepts at any time, no API call needed
• Analytics dashboard — weak/fragile/resolved counts, confidence breakdown, trap-type patterns, and quiz score trends over time
• Reviewer button — floating button shows cards until next quiz; one click opens the progress panel or launches a waiting quiz
• Undo-aware counter — pressing Undo in the reviewer correctly decrements the progress counter; no inflation from re-answers
• Pause / resume — temporarily disable quiz generation without losing your place
• Local caching — identical concept batches reuse a cached quiz so you never pay for the same API call twice

⚠️ API SETUP — REQUIRED

This add-on uses an AI API to generate quiz questions. You will need an API key from OpenAI or Anthropic (Claude) before quizzes will generate.

Step 1 — Get an API Key

Option A: OpenAI (recommended)

• Go to: platform.openai.com/api-keys
• Log in or create a free account
• Click "Create new secret key" and copy it (starts with sk-...)

Option B: Claude (Anthropic)

• Go to: console.anthropic.com
• Log in or create an account → navigate to API Keys → click "Create Key"

Step 2 — Add Your Key in Anki

• Open Anki → Tools → Add-ons → AnkiQuiz MCAT → Config
• Fill in the fields:

"api_provider": "openai", "api_key": "sk-xxxxxxxxxxxxxxxx", "model": "gpt-4o-mini"

Step 3 — Choose a Model

• gpt-4o-mini — recommended for daily use; lowest cost (~$0.01–0.03 per quiz)
• gpt-4o — higher quality, higher cost
• Any current OpenAI or Anthropic chat model is supported

Step 4 — Save and Restart

• Click Save in the config window, then restart Anki
• The add-on is now ready — just start reviewing cards as normal

WHO THIS IS FOR

• 🩺 MCAT students who want to build AAMC-style reasoning alongside their card reviews
• 📚 Anyone using Anki who wants to move beyond passive recall into active application
• 🎯 Students who want better retention — testing yourself is one of the most evidence-backed study methods

IMPORTANT NOTES

• This add-on does not modify your Anki cards, notes, or scheduling in any way
• All tracking and analytics are stored locally on your machine
• Works with any deck, but is optimized for MCAT-style content

COMPATIBILITY

• Anki 23.x – 25.x (Qt6 builds)
• Tested on Anki 25.02.5 · Python 3.9+ · macOS / Windows / Linux
• Older Anki versions may work but are not officially tested

PRIVACY & DATA

• Card concepts are sent to the AI provider you configure — no other data leaves your machine
• Quiz history and missed-concept data are stored in a local JSON file inside the add-on folder — nothing is written to your Anki collection
• No analytics. No telemetry. No external servers beyond the single API call you explicitly set up.

IN SUMMARY

AnkiQuiz combines the memory power of Anki with the application power of active testing:

Anki → memorization AnkiQuiz → application + exam reasoning

So you are not just remembering information — you are actively practising how to use it.