Run Numeris lessons inside your local VS Code with real
Python. Sign in with your numeris.app account, pick a lesson, run + validate
get instant XP — and chat with the Numeris AI tutor without leaving the
editor.
Install
Search for Numeris Classroom in the VS Code marketplace, or use the
one-click link from your dashboard: https://numeris.app/install.
Make sure Python 3.11+ is on your PATH. The extension will prompt to
install it on first run if missing.
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 → scaffold unpacks to a temp folder under VS Code's
globalStorage.
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.
AI Chat sidebar talks to Anthropic / Gemini / OpenAI through the
numeris.app proxy. Daily token budget per student keeps costs in check.
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).
AI calls: prompts and responses are not stored on Numeris servers
past 24 h (debug retention only). Provider keys (Anthropic, Gemini,
OpenAI) live exclusively on numeris.app — never shipped to your
machine.
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.
