CoolFace
Apppublic

Kambere-44/ai-teacher-assistant

sourceHugging Faceupdated 7mo agoView on Hugging Face
1likes
App README

๐ŸŽ“ AI Teacher Assistant

Python Streamlit AI License Status

An AI-Powered Teaching Companion designed to help educators automate academic tasks, analyze student performance, and improve teaching efficiency using modern Artificial Intelligence.


๐ŸŒ Live Demo

Try the application online:

๐Ÿš€ Streamlit Deployment

https://ai-assistant-for-teachers.streamlit.app

๐Ÿค— Hugging Face Deployment

https://huggingface.co/spaces/Kambere-44/ai-teacher-assistant


๐Ÿ“– Project Overview

Teachers spend a large portion of their time performing repetitive academic tasks such as:

โ€ข Creating quizzes and assessments โ€ข Analyzing student performance โ€ข Preparing lesson plans โ€ข Summarizing learning materials โ€ข Providing individualized student support

These activities reduce time available for student engagement and personalized learning.

The AI Teacher Assistant solves this by integrating Artificial Intelligence into the teaching workflow, allowing teachers to automate tasks and focus more on teaching.


โœจ Key Features

๐Ÿ“Š Student Performance Analysis

Upload classroom datasets and receive instant insights.

Features include:

  • โ€”Student performance breakdown
  • โ€”Attendance analytics
  • โ€”Data visualization dashboards
  • โ€”Class trend analysis
  • โ€”AI recommendations for improvement

๐Ÿ“ AI Quiz Generator

Generate quizzes automatically for faster classroom assessments.

Capabilities include:

  • โ€”Auto-generated MCQ questions
  • โ€”Adjustable difficulty levels
  • โ€”Downloadable DOCX exam papers
  • โ€”Instant test creation

๐Ÿ“š Lesson Summarization

Convert large lesson materials into clear and concise summaries.

Teachers can:

  • โ€”Upload lesson PDFs
  • โ€”Extract key concepts automatically
  • โ€”Generate quick revision notes
  • โ€”Simplify teaching preparation

๐Ÿง  AI Lesson Planner

Generate structured lesson plans in seconds.

The AI creates:

  • โ€”Learning objectives
  • โ€”Teaching activities
  • โ€”Student engagement techniques
  • โ€”Assessment strategies
  • โ€”Multimedia learning suggestions

๐Ÿ’ฌ AI Counsellor for Teachers

A supportive AI assistant designed to help teachers manage classroom stress and professional burnout.

Provides:

  • โ€”Stress support
  • โ€”Reflective teaching guidance
  • โ€”Classroom challenge advice
  • โ€”Positive reinforcement conversations

๐Ÿ“ธ Application Preview

๐Ÿ“Š Student Performance Analysis

[image]


๐Ÿง  AI Lesson Planner

[image]


๐Ÿ“š Lesson Summarizer

[image]


๐Ÿ“ Quiz Generator

[image]


๐Ÿ’ฌ Teacher Wellness Assistant

[image]


๐Ÿง  Technology Stack

TechnologyPurpose
PythonBackend logic
StreamlitInteractive web interface
OpenAI GPTAI reasoning & content generation
PandasData analysis
MatplotlibData visualization
SeabornStatistical graphs
Python-DOCXExam paper generation
PyPDFLesson text extraction

๐Ÿ—๏ธ Project Structure

AI-Assistant
โ”‚
โ”œโ”€โ”€ app.py
โ”œโ”€โ”€ ai.py
โ”œโ”€โ”€ animations.py
โ”œโ”€โ”€ customquery.py
โ”œโ”€โ”€ LessonPlan.py
โ”œโ”€โ”€ lessonSummarize.py
โ”œโ”€โ”€ MCQ.py
โ”œโ”€โ”€ teacheanalysis.py
โ”œโ”€โ”€ wellness.py
โ”‚
โ”œโ”€โ”€ dataset_for_hackprix.csv
โ”œโ”€โ”€ screenshots
โ”‚   โ”œโ”€โ”€ perfomance_analysis.png
โ”‚   โ”œโ”€โ”€ teacher_wellness.png
โ”‚   โ”œโ”€โ”€ lesson_summarize.png
โ”‚   โ”œโ”€โ”€ lesson_plan.png
โ”‚   โ””โ”€โ”€ generate_quiz.png
โ”‚
โ”œโ”€โ”€ requirements.txt
โ””โ”€โ”€ README.md

โš™๏ธ Installation

1๏ธโƒฃ Clone Repository

bash
git clone https://github.com/Kambere-44/AI-Assistant-For-Teachers.git
cd AI-Assistant-For-Teachers

2๏ธโƒฃ Create Virtual Environment

bash
python -m venv venv

Activate environment

Windows

venv\Scripts\activate

Linux / Mac

source venv/bin/activate

3๏ธโƒฃ Install Dependencies

bash
pip install -r requirements.txt

4๏ธโƒฃ Run the Application

bash
streamlit run app.py

๐ŸŽฏ Target Users

  • โ€”Teachers
  • โ€”Schools
  • โ€”Online educators
  • โ€”Academic institutions
  • โ€”Educational researchers

๐Ÿš€ Future Improvements

Planned upgrades include:

  • โ€”AI grading assistant
  • โ€”Curriculum generator
  • โ€”Student progress prediction
  • โ€”LMS integration
  • โ€”Voice-enabled teaching assistant
  • โ€”Uganda syllabus dataset integration

๐Ÿ‘จโ€๐Ÿ’ป Author

Mark Kambere

AI Developer | Software Engineer | EdTech Innovator

GitHub https://github.com/Kambere-44


๐Ÿ“œ License

This project is licensed under the MIT License.


โญ Support the Project

If you find this project useful:

โญ Star the repository ๐Ÿด Fork the project ๐Ÿค Contribute improvements


โœ… After updating the README, push it:

bash
git add README.md
git commit -m "Updated README with screenshots and live demos"
git push