Skip to content

ismiljanic/TeachMe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

143 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TeachMe

An AI-powered interactive learning platform that transforms digital education through intelligent tutoring and adaptive learning experiences.

Overview

TeachMe simulates a virtual student that actively engages with uploaded educational materials. The system processes documents, participates in interactive dialogues, generates assessments and provides comprehensive learning analytics. By leveraging AI technology, TeachMe creates a dynamic learning environment where users can teach concepts to an AI student, reinforcing their own understanding through principle of learning-by-teaching.


Technology Stack

Component Technology
Frontend React, TailwindCSS
Backend .NET 8
Database PostgreSQL
AI Engine OpenAI GPT API
AI Service Python (FastAPI)

Features

Document Processing

  • PDF and document upload with automatic text extraction
  • Intelligent content parsing and indexing

AI Student Simulation

  • Configurable knowledge levels and learning styles
  • Context-aware responses based on uploaded materials
  • Natural language interaction with voice support

Interactive Learning Sessions

  • Two-way conversational Q&A interface
  • Real-time feedback and clarification requests
  • Session-based conversation memory

Assessment Generation

  • Dynamic quiz creation from study materials
  • Multiple-choice and open-ended question formats
  • Automated grading and performance tracking

Analytics Dashboard

  • Learning progress visualization
  • Historical session data and scores
  • AI-generated study summaries and key insights

System Architecture

TeachMe/
├── ai-service/
│   ├── coquiTTS.py
│   └── coquiTTSUpute.md
│   └── main.py
│   └── models.py
│   └── openai_client.py
│   └── quiz_agent.py
│   └── quiz_router.py
│   └── summary_agent.py
│   └── summary.py
│   └── teachme_workflow.py
│   └── textFromPdf.py
│
├── assets/
|
├── backend/
│   ├── Controllers/
│   ├── Data/
│   ├── DTO/
│   ├── HttpClients/
│   ├── Migrations/
│   ├── Models/
│   ├── Services/
│   ├── Summaries/
│   └── appsettings.json
│   └── Program.cs
│   └── TeachMe.csproj
│
├── database/
│   ├── scripts/
│       ├── teachme_db_schema_v1.sql
│   └── ERDiagram.png
│   └── README.md
|
├── docs/
│   ├── api-specs.md
│   ├── architecture.md
│   ├── database-setup.md
│   ├── documentation.pdf
│   ├── environment-setup.md
│   ├── README.md
│   ├── setup-guide.md
│   ├── user-guide.md
│
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── pages/
│   │   ├── services/
│   │   ├── styles/
│   │   ├── utils/
│   │   └── App.tsx
│   │   └── index.css
│   │   └── main.tsx
│   │   └── vite-env.d.ts
│   └── index.html
│   └── package.json
│   └── vite.config.ts
│
├── LICENSE/
└── README.md

User Workflow

  1. Content Upload: User uploads educational materials (PDF only for now)
  2. Content Processing: System extracts content from materials
  3. AI Initialization: AI agent "studies" the material and prepares for interaction
  4. Learning Session: User engages in teaching dialogue with AI student
  5. Assessment: System generates quizzes or prompts knowledge checks
  6. Analysis: Performance metrics and summaries are compiled
  7. Review: User accesses dashboard to track progress and insights

Project Objectives

  • Educational Innovation: Demonstrate practical application of AI in digital learning environments
  • Technical Integration: Showcase seamless integration between LLM APIs and traditional web technology stacks
  • User Experience: Deliver an intuitive, measurable and engaging learning platform
  • Academic Application: Fulfill digital education course requirements with production-quality software

Demonstration

Homepage

homepage

User Dashboard

dashboard

User Chat

chat

Load Quiz

User Analytics

analytics

analytics2

AI Profile

ai_profile_1

ai_profile_2

Future Roadmap

Planned Enhancements

  • Collaborative Learning: Multi-user study sessions with shared AI interaction
  • Enhanced Interaction: AI voice synthesis and avatar visualization
  • Personal Knowledge Integration: MCP (Model Context Protocol) integration for personal note management
  • Adaptive Learning Paths: AI-driven curriculum recommendations based on performance patterns
  • Mobile Application: Native iOS and Android applications

License

This project is developed as part of an academic curriculum. All rights reserved by the development team.

About

AI-powered interactive learning application that studies uploaded materials, simulates a student, asks and answers questions and generates quizzes and study summaries.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors