File size: 1,290 Bytes
c72a1e8 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | # StudyAgent
ADHS-friendly study buddy: helps students with ADHS get through their semester.
No rigid plans — micro-steps, buddy tone, dopamine at task START not completion.
## Status
MVP shipped. Browser E2E test and past-deadline edge case pending.
## Run
```bash
cd ~/Projekte/StudyAgent
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
# Optional — without key, fallback steps run instead
cp .env.example .env
# edit .env: set MINIMAX_API_KEY
source .env # or use python-dotenv
uvicorn main:app --reload
# → http://localhost:8000
```
## What works
- Dashboard — active subjects, next deadlines, next step, session banner, panic indicators
- Subjects CRUD — WIP limit of 2 enforced server-side
- Deadlines — auto-generates micro-steps via MiniMax M2.5 on creation
- Steps — complete/skip inline (htmx), next step loads automatically
- Elastic plan — auto-compresses when steps exceed remaining time
- Replan — deletes pending+skipped, generates fresh
- Session tracking — auto-start, auto-close after 30 min inactivity
- Panic mode — triggers at <48h, reduces to 3-4 essential steps
- AI fallback — works without MINIMAX_API_KEY (dummy steps)
## Stack
FastAPI + SQLAlchemy + SQLite + htmx + Jinja2 + MiniMax M2.5 API
|