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 Infrom 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 = falsein 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.