How mahikushwaha/studypilot works
StudyPilot is a Flask study-planning app. Students use its web interface to set up subjects and syllabus, plan around exams, and review next steps; the backend can calculate readiness and daily study hours, negotiate a realistic target, and provide a readiness report. The README also describes accounts, persistent preferences and topics, chat memory, and retrieval over study tips and pending topics. The available source excerpt covers agent behavior, but not Flask routes or storage implementation, so those relationships are shown only where the README documents them.
Main entry points: index.html Study web interface · agent.py Study agent · app.py Planner
Components 18
Student experience
- Study web interface
static/index.html - Guided setup
app.py - Syllabus input
app.py - Next step cards
app.py
Study planning
- Planner
app.py - Readiness check
agent.py - Hours calculator
agent.py - Plan negotiation
agent.py - Readiness report
agent.py
Agent and retrieval
- Study agent
agent.py - Study-tip retrieval
agent.py - Pending-topic retrieval
agent.py - Chat memory
app.py - Ollama or OpenRouter
Accounts and persistence
- Account and tokens
app.py - Student preferences
app.py - SQLite or Postgres
app.py
Other components
- Student
Connections 19
- Student → Study web interface: uses
README.md - Study web interface → Guided setup: supports setup
README.md - Study web interface → Syllabus input: uploads or pastes
README.md - Study web interface → Planner: opens planner
README.md - Planner → Next step cards: shows next steps
README.md - Planner → Study agent: requests planning
README.md - Study agent → Readiness check: dispatches tool
agent.py - Study agent → Hours calculator: dispatches tool
agent.py - Planner → Plan negotiation: negotiates target
README.md - Planner → Readiness report: checks plan
README.md - Study agent → Ollama or OpenRouter: invokes model
agent.py - Study agent → Study-tip retrieval: retrieves tips
README.md - Study agent → Pending-topic retrieval: retrieves topics
README.md - Study web interface → Chat memory: maintains chat
README.md - Study web interface → Account and tokens: supports accounts
README.md - Account and tokens → SQLite or Postgres: stores account data
README.md - Student preferences → SQLite or Postgres: stores preferences
README.md - Chat memory → SQLite or Postgres: stores memory
README.md - Syllabus input → SQLite or Postgres: stores subjects and topics
README.md