How rohannx29/ai-learner works
AI-Learner is a web-based learning assistant. Users interact through a Next.js frontend; the FastAPI application routes requests to account, notes, RAG, tutor, roadmap, and explanation features. The documented study-material workflow processes uploads into chunks and vector storage, then retrieves and reranks notes to ground AI answers. The graph includes that ingestion path and the symbolic-math branch. Some subsystem links rely on README documentation or source-index references; unsampled implementation details are not inferred.
Main entry points: main.py FastAPI application · rag_engine.py Notes answer engine · dependencies.py Token verification · notes_api.py Notes upload routes
Components 26
Web frontend
- Next.js interface
frontend-next/src/app - API client
frontend-next/src/lib/api.js
API and identity
- FastAPI application
app/main.py - Account routes
app/api/auth_api.py - Password and tokens
app/auth/auth_utils.py - Token verification
app/auth/dependencies.py
Learning features
- Explanation route
app/api/explain_api.py - Notes upload routes
app/api/notes_api.py - Notes question route
app/api/rag_api.py - Tutor route
app/api/tutor_api.py - Roadmap route
app/api/roadmap_api.py - Notes answer engine
app/ai_engine/rag_engine.py - Symbolic solver
app/ai_engine/math_engine.py - Numerical prompt
app/ai_engine/math_prompts.py - LLM generation
app/ai_engine/llm_engine.py - Tutor chat engine
app/ai_engine/tutor_engine.py - Roadmap generator
app/ai_engine/roadmap_engine.py
Processing and storage
- Document extraction
app/utils/document_reader.py - Math OCR
app/utils/math_ocr.py - Text chunking
app/utils/text_chunker.py - Vector retrieval
app/ai_engine/vector_db.py - Relational database
app/db/database.py - User model
app/db/models.py
Other components
- Learner
- Ollama model service
- ChromaDB
Connections 35
- Learner → Next.js interface: uses
README.md - Next.js interface → API client: requests through
- API client → FastAPI application: sends requests
README.md - FastAPI application → Account routes: registers
app/main.py - FastAPI application → Explanation route: registers
app/main.py - FastAPI application → Notes upload routes: registers
app/main.py - FastAPI application → Notes question route: registers
app/main.py - FastAPI application → Roadmap route: registers
app/main.py - FastAPI application → Tutor route: registers
app/main.py - Account routes → Password and tokens: uses
app/api/auth_api.py - Account routes → Relational database: queries and writes
app/api/auth_api.py - Relational database → User model: creates tables
app/main.py - Notes upload routes → Token verification: requires identity
app/api/notes_api.py - Notes question route → Token verification: requires identity
app/api/rag_api.py - Tutor route → Token verification: requires identity
app/api/tutor_api.py - Roadmap route → Token verification: requires identity
app/api/roadmap_api.py - Explanation route → Token verification: requires identity
app/api/explain_api.py - Notes upload routes → Text chunking: chunks text
app/api/notes_api.py - Notes upload routes → Vector retrieval: stores chunks
app/api/notes_api.py - Document extraction → Math OCR: uses
app/utils/document_reader.py - Learner → Document extraction: uploads material
README.md - Document extraction → Text chunking: extracts for chunking
README.md - Text chunking → Vector retrieval: prepares embeddings
README.md - Vector retrieval → ChromaDB: persists and retrieves
README.md - Notes question route → Notes answer engine: calls
app/api/rag_api.py - Notes answer engine → Vector retrieval: queries chunks
app/ai_engine/rag_engine.py - Notes answer engine → Symbolic solver: tries symbolic solve
app/ai_engine/rag_engine.py - Notes answer engine → Numerical prompt: formats math prompt
app/ai_engine/rag_engine.py - Notes answer engine → LLM generation: generates answer
app/ai_engine/rag_engine.py - LLM generation → Ollama model service: sends prompt
app/ai_engine/llm_engine.py - Tutor route → Tutor chat engine: calls
app/api/tutor_api.py - Tutor chat engine → Ollama model service: chats with
app/ai_engine/tutor_engine.py - Roadmap route → Roadmap generator: calls
app/api/roadmap_api.py - Roadmap generator → Ollama model service: generates with
app/ai_engine/roadmap_engine.py - Explanation route → LLM generation: requests explanation
app/api/explain_api.py