Skip to content

itsomg134/Teach-the-Tutor-Active-Recall-Coach

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧬 Teach-the-Tutor: Biology Active Recall Coach

Version Python TypeScript JavaScript Shell Dockerfile License

An AI-powered Active Recall Coach that helps biology students learn, quiz, and teach-back concepts through real-time voice interaction. Built for the #MurfAIVoiceAgentsChallenge.

Features β€’ Project-Structure β€’ Quick-Start β€’ Demo-Video β€’ Author


🧬 Teach-the-Tutor: Biology Voice Learning Companion

A smart biology tutor that explains concepts, quizzes you, and evaluates your β€œteach-back” β€” helping you master biology using proven Active Recall.


πŸ“Œ Overview

Biology is memory-heavy: diagrams, cycles, definitions, mechanisms, NCERT facts β€” everything must be remembered and understood clearly.

This project is a voice-based Active Recall Coach designed for:

βœ”οΈ NEET Aspirants βœ”οΈ Class 11–12 Biology Students βœ”οΈ B.Sc. Life Science Students βœ”οΈ Anyone wanting to deeply understand biology

The AI coach follows a 3-step learning system:

1️⃣ Learn Mode

Explains any biology topic simply (Cell Division, Genetics, Photosynthesis, Human Physiology, etc.)

2️⃣ Quiz Mode

Asks MCQs and short-answer questions to check your retention.

3️⃣ Teach-Back Mode

You explain the concept β€” and the AI gives feedback like a real tutor.


Untitled.video.3.mp4

πŸŽ₯ Demo Video

πŸ“Ž https://drive.google.com/file/d/1uPmIqE8OVfHCjjbNrZhUWbfQ-GW85apC/view?usp=vids_web


🎯 Features

βœ” Concept Explanation (Learn Mode)

  • Simplified explanations for all biology chapters
  • Includes diagrams (verbal), examples, and keywords
  • Follows NCERT-aligned structure

βœ” Quiz Mode for Active Recall

  • MCQ, one-word, and 3-line answer questions
  • Randomized or topic-based quizzes
  • Immediate feedback

βœ” Teach-Back Analysis

  • You explain the concept
  • AI scores clarity, key terms, and accuracy
  • Gives improvement suggestions

βœ” Session Memory (JSON Persistence)

Stores:

  • Topics studied
  • Quiz performance
  • Previous mistakes
  • Teach-back scores

The agent uses past data to adapt future sessions.

βœ” Grounded & Safe

  • No medical advice
  • No misinformation
  • Only academic biology learning support

πŸ› οΈ Tech Stack

  • Python
  • TypeScript
  • Murf Falcon Voice Models
  • JSON Storage
  • Docker (Optional)
  • Speech-to-Text + Text-to-Speech

πŸ“ Project Structure

/Teach-the-Tutor-Biology-Voice-AI
β”‚
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ agent.py
β”‚   β”œβ”€β”€ active_recall.py
β”‚   β”œβ”€β”€ memory_manager.py
β”‚   β”œβ”€β”€ quiz_bank.json
β”‚   └── biology_topics/
β”‚
β”œβ”€β”€ logs/
β”‚   └── session_memory.json
β”‚
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ docker-compose.yml
└── README.md

βš™οΈ Quick Start

1. Clone the Repo

git clone https://github.com/yourusername/Teach-the-Tutor-Biology.git
cd Teach-the-Tutor-Biology

2. Install Dependencies

pip install -r requirements.txt

3. Run the Biology Voice Tutor

python src/agent.py

πŸ§ͺ Sample JSON Output

{
  "date": "2025-11-25",
  "topic": "Cell Cycle - Mitosis",
  "quiz_score": 4,
  "teach_back_accuracy": "78%",
  "notes": "User understood prophase and metaphase well. Needs clarity on anaphase."
}

πŸš€ Future Improvements

  • Add diagram image support
  • Adaptive difficulty quizzes
  • Biology formula sheet generator
  • NEET weekly full-length mock tests
  • Web dashboard to view progress

πŸ‘¨β€πŸ’» Author

Om Gedam

GitHub: @itsomg134 Email: omgedam123098@gmail.com Twitter (X): @omgedam LinkedIn: Om Gedam Portfolio: https://ogworks.lovable.app

Built with ❀️ for every biology learner. Brown and Beige Modern AI Features YouTube Thumbnail

Just tell me!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published