Anki add-on: NBOME Pearl Injector (Gemini AI)

NBOME Pearl Injector is a COMLEX-focused upgrade to batch unsuspend: run bulk Unsuspend and optional Forget reset-to-New on matched cards, then optionally add AI-generated NBOME pearls in the same pass. It targets AnKing Step 1 / 2 / 3 v12 and supports UWorld , COMBANK , and AMBOSS question IDs, plus a Today’s Reviews workflow. Scheduler-only actions work even when pearl injection is turned off. NBOME Pearl Injector (v1.0.21) Bring Your Own Key (BYOK) add-on for osteopathic medical students. Uses Gemini AI to inject concise, high-yield NBOME/COMLEX pearls into AnKing cards. The add-on stays free because you provide your own Gemini API key: there is no bundled paid API, and usage is between you and Google. Also works as a COMLEX-focused batch unsuspend/reset tool: you can run scheduler actions (Unsuspend and/or Forget reset-to-New) on matched cards even when pearl injection is turned off. Why This Is Different Batch Unsuspend + Reset: run scheduler-only workflows in bulk (no API key needed if pearls are off). Multi-Qbank targeting: paste UWorld, COMBANK, or AMBOSS IDs under the matching AnKing tag family. COMLEX-aware UWorld matching: Step 1 / 2 searches both UWorld Step and COMLEX tag paths. Pearl updates without duplicate clutter: updates existing add-on pearls, or appends a first pearl when absent. Abort mid-run: stop a long Gemini batch with Abort / Esc and keep notes already saved. Auto-sync option: optional AnkiWeb sync every 30 minutes while Anki is open (skips while reviewing). Retry handling: transient Gemini “high demand” errors are retried automatically instead of failing immediately. Core Features Question IDs mode: paste UWorld / COMBANK / AMBOSS IDs and run pearls and/or scheduler actions on matched notes. Today’s Reviews mode: uses is:due -is:suspended , scoped to selected AnKing track. Track support: Step 1 / Step 2 / Step 3 v12, plus Custom prefix and Legacy wildcard. Unsuspend: activates suspended matched cards. Forget reset: resets only suspended matched cards to New (does not reset non-suspended cards). Safety cap: local daily request cap (default 250) for Gemini calls. Abort / Esc: cancel pearl injection early if you started a long run by mistake. Optional manual review: off by default; if enabled, only empty/unusually long pearls are queued (with source card shown for comparison). Suggested AMBOSS workflow In AMBOSS Qbank, use Get Anki Cards and copy the Anki query for the questions you want. Paste that query into Anki Browse, then unsuspend / study those cards as usual (AMBOSS’s official bridge). When those cards are in your study load, open this add-on and choose Today’s Reviews + inject NBOME pearls (optionally unsuspend if needed). Or paste AMBOSS QIDs directly (Qbank tags = AMBOSS) if you prefer ID paste over the AMBOSS query. What's New in v1.0.21 Suspicious-pearl flood fixed: “new terms not on the card” no longer auto-flags almost every pearl (NBOME pearls are supposed to add new COMLEX facts). Manual review off by default: normal pearls inject directly again. Better review preview (optional): if you enable review in Config, it shows card Front/Back plus the pearl, and only flags empty or absurdly long outputs. What shipped in v1.0.20 COMBANK support: paste COMBANK QIDs (or names like Assessment_2) under #AK_Step*_v12::#COMBANK::… . AMBOSS support: paste AMBOSS IDs (e.g. -0aDiQ ) under #AK_Step*_v12::#AMBOSS::… . Qbank selector: choose UWorld, COMBANK, or AMBOSS in the inject dialog; choice is saved. What shipped in v1.0.19 Abort during pearl injection: visible Abort button + Esc; already-saved notes are kept, remaining notes are skipped. Auto-sync reliability fix: uses Anki’s real Sync path, restarts when you toggle the option, and can sync once when newly enabled. What shipped in v1.0.17 NBOME / COMLEX calibration: tighter Gemini instructions for DO-board framing (no fake citations). Auto-sync option: optional 30-minute sync while Anki is open. Gemini retry support: transient demand spikes are retried automatically. What shipped in v1.0.16 Forget safety fix: reset now applies only to suspended matched cards. Today’s Reviews protection: Forget is blocked in due-card mode. Replace/update improved: existing add-on pearls are updated; first pearls can still be added when absent. Clearer run summaries and ID match reporting. Setup Get a Gemini API key: Google AI Studio In Anki: Tools → Add-ons → NBOME Pearl Injector → Config Run: Tools → Inject NBOME Pearls (UWorld IDs) Choose deck/track + Qbank tags (UWorld / COMBANK / AMBOSS), then paste IDs or use Today’s Reviews Disclaimer: AI can hallucinate. Always verify critical clinical and OMM facts. Created by Kyle Bringhurst | Founder of SyncSOAP

GitHub repository: bringhurstdo/anki_nbome
Repository description: Auto-injects COMLEX pearls into AnKing cards using UWorld IDs & Gemini AI
Languages: Python