Inspiration

Modern learning is broken.

We consume endless tutorials — YouTube, GitHub, PDFs — but most of what we gain is familiarity, not understanding. Traditional quizzes only check surface recall. They can’t detect why you believe something.

We wanted to build a system that doesn’t test memory — it tests mental models.

That’s how LearnLock was born.


What LearnLock Does

LearnLock is an adversarial AI tutor that:

  1. Ingests real learning sources (YouTube, GitHub, PDFs, articles)
  2. Extracts ground-truth conceptual claims
  3. Models what the user believes
  4. Actively interrogates that belief until it collapses or becomes correct

Instead of asking “What is X?”, it asks:

“If you believe X works this way, what happens when Y?”

This forces the learner to expose hidden misunderstandings.


How We Built It

LearnLock is built around a Duel Engine, a multi-stage AI system:

  • Claim Extraction
    LLM converts source material into falsifiable conceptual claims.

  • Belief Modeling
    Each user response is turned into a one-sentence mental model.

  • Contradiction Detection
    The belief is checked against claims to find missing mechanisms, wrong assumptions, or boundary errors.

  • Adversarial Interrogation
    The AI generates a surgical follow-up question that targets the most critical flaw.

  • Spaced Repetition (SM-2)
    Errors determine future review scheduling.

All of this runs inside a fully interactive CLI.


Challenges

The hardest part was ensuring claims were:

  • Conceptual (not tautologies)
  • Falsifiable
  • Stable enough to test beliefs against

We built a two-pass claim verifier and strict hallucination guards so the AI cannot invent violations that don’t map to real claims.


What We Learned

We learned that learning is not about answers — it’s about models.

By forcing an AI to reason about what someone believes instead of what they typed, we unlocked a completely new kind of educational feedback.

This is not a chatbot. This is a cognitive debugger.

Documentation - https://learnlock.vercel.app

Install - pip install learn-lock

Github - https://github.com/MitudruDutta/learnlock

Built With

Share this project:

Updates