Installation

uv manages Python and the dependencies. Install it once, then clone.

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

git clone https://github.com/GustavoPenaBeltrami/self-learning-platform.git
cd self-learning-platform
uv run slp

requires

python ≥ 3.9, fetched by uv

deps

mlx-whisper on Apple Silicon, faster-whisper elsewhere. Only dictation uses them

keep your topics

git remote set-url origin <your-repo>

// want dictation ready offline? run uv run slp setup right after cloning

Recommended setup

Your material, the app and the agent side by side. Two monitors help.

┌──────────┬──────────┬──────────┐
│ material │   app    │  agent   │
│  pdf     │  notes   │  /slp-*  │
│  course  │  exams   │          │
│          │  cards   │          │
└──────────┴──────────┴──────────┘

1 · material

the PDF, the course, the docs. Whatever you're studying

2 · app

uv run slp in the browser: notes, cards, exams, exercises, settings

3 · agent

open at the repo root. Teaches, builds exams, grades

Next: getting started.