An AI-powered educational assistant built using LangChain, Hugging Face Embeddings, Groq LLMs, FAISS, and Streamlit.
EduSmart AI Tutor helps students learn more effectively through document-based question answering, AI tutoring, research assistance, summarization, quiz generation, and personalized learning experiences.
Students can upload:
- PDF files
- DOCX files
- TXT files
The system:
- Extracts content from uploaded documents
- Splits text into chunks
- Creates embeddings using MiniLM
- Stores vectors in FAISS
- Retrieves relevant information
- Generates contextual answers using an LLM
Students can ask general questions such as:
- Explain Machine Learning
- What is Photosynthesis?
- How does Blockchain work?
- Explain Newton’s Laws
The tutor provides conversational and educational responses.
The tutor can retrieve information from Wikipedia for factual and historical topics.
Examples:
- Who was Albert Einstein?
- History of the Internet
- What is Quantum Computing?
The tutor can search research papers from ArXiv.
Examples:
- Latest research on LLMs
- Papers on Reinforcement Learning
- Research about Computer Vision
Supports mathematical calculations.
Examples:
- 25 * 30
- 500 / 25
- (45 + 20) * 3
- Document Summarization
- Quiz Generation
- Flashcard Creation
- Context-Aware Learning
- Conversational Chat Interface
User
↓
Streamlit Frontend
↓
Router
├── Document QA (RAG)
├── General Tutor
├── Wikipedia Tool
├── ArXiv Tool
└── Calculator Tool
↓
Groq LLM
↓
Response
- Streamlit
- Groq
- Llama 3.3 70B Versatile
- LangChain
- LangGraph
- sentence-transformers/all-MiniLM-L6-v2
- FAISS
- Wikipedia API
- ArXiv API
- Calculator Tool
- PyPDF
- python-docx
EduSmart-AI-Tutor/
│
├── app.py
│
├── src/
│ │
│ ├── llm.py
│ ├── embeddings.py
│ ├── tools.py
│ ├── agents.py
│ ├── tutor.py
│ ├── memory.py
│ │
│ ├── doc_loader.py
│ ├── vector_store.py
│ └── retriever.py
│
├── uploads/
│
├── requirements.txt
│
├── .env
│
└── README.md
git clone <https://github.com/Shreshth1805/AI-Tutor>
cd EduSmart-AI-Tutorpython -m venv tutortutor\Scripts\activatesource tutor/bin/activatepip install -r requirements.txtstreamlit
langchain==0.3.25
langchain-core==0.3.59
langchain-community==0.3.24
langchain-groq
langchain-openai
langchain-huggingface
langgraph
faiss-cpu
sentence-transformers
pypdf
python-docx
python-dotenv
Create a .env file:
GROQ_API_KEY=your_groq_api_keystreamlit run app.pyApplication will launch at:
http://localhost:8501
- Summarize this document
- Explain chapter 3
- Generate quiz questions
- Create flashcards
- Explain Machine Learning
- What is Deep Learning?
- Difference between AI and ML
- Who was Isaac Newton?
- History of India
- Latest transformer research papers
- Papers on Retrieval-Augmented Generation
- 120 * 45
- 5000 / 25
This project is designed with educational use in mind.
Recommendations for production deployment:
- Encrypt uploaded files
- Implement authentication
- Restrict file access
- Add content moderation
- Store conversation history securely
- Comply with COPPA and GDPR requirements when working with minors
- Voice-Based Tutor
- Multi-Language Support
- Personalized Learning Paths
- Student Progress Tracking
- Teacher Dashboard
- LangGraph Agent Workflows
- Persistent Memory with PostgreSQL
- Vector Database Migration (Chroma / Pinecone)
- Study Planner Agent
- Career Guidance Agent
This project demonstrates:
- Retrieval-Augmented Generation (RAG)
- LangChain Pipelines
- Tool Calling
- Vector Search
- Educational AI Systems
- Conversational Interfaces
- LLM Integration
- Agent-Based Workflows
- Streamlit Deployment
.png)