Run Numeris lessons inside your local VS Code with real
Python. Sign in with your Numeris account, pick a lesson, run + validate
get instant XP, without leaving the editor.
Install
Search for Numeris Institute Classroom in the VS Code marketplace, or use the
install link on any lesson's Open in VS Code card.
Install Python 3.12 or newer from https://www.python.org/downloads/. In
the installer, tick Add python.exe to PATH, then close and reopen VS
Code. If Python is missing, the extension shows these steps on first run.
Run Numeris: Sign In from the command palette (Ctrl+Shift+P /
Cmd+Shift+P). A browser window opens for one-click approval.
Usage
Lessons sidebar (Numeris activity bar icon) lists every lesson you're
enrolled in across all programs (python-max, python-smart-1, etc.).
Click a lesson (each track is listed separately) → scaffold unpacks to a
folder under VS Code's globalStorage, one folder per Numeris account, so
students sharing a PC don't share files. Reopening a lesson refreshes its
README but never overwrites a task_* file you have already got.
Open task_NN_*.py → click Run task code lens → output streams to
the integrated terminal.
Click Validate → server compares output against the lesson's
expected, awards XP if correct.
Building from source
cd extension
npm install
npm run compile
# F5 in VS Code launches the Extension Development Host
Telemetry & privacy
Auth: device-code flow, JWT stored in OS keychain (VS Code SecretStorage).
No AI: the extension sends nothing to an AI model (the AI chat was
removed in 0.2.0).
Set numeris.telemetry = false in settings to opt out of usage
metrics. Auth + lesson + validation calls always happen since they're
required for the extension to function.
License
UNLICENSED — internal tool published to the marketplace for Numeris
students. Do not redistribute.
