Hands-on practice for junior interviews: backend, data analyst and AI engineer on one shared core, plus object-oriented design in practice and a reverse engineering sprinkle. Short narrated lessons, exercises with real tests, and a tutor that reads your code.
Created by Avi.
- Node 24 or newer, and pnpm
- Python 3.13 with
pip install -r requirements.txt(for the Python lessons) - VS Code with its
codecommand on your PATH (the trainer runscode serve-web)
pnpm install
pnpm start # builds lessons, installs the extension, opens VS Code in the browserVS Code opens with the next unfinished lesson on the right and your exercise file on the left. First time only: click Trust when VS Code asks (it is your own folder, served only to this machine, behind a token). The URL keeps the same token between runs, so you can bookmark it.
Press Run my tests in the lesson, or pnpm lesson test <track>/<lesson>. A results table next to the test output lists each failing test with its input, the expected value and what your code returned. Pass and the next lesson opens. A run that never finishes (an infinite loop in your code) is stopped after 90 seconds with a hint.
The same trainer runs in the browser at https://avi-interview-prep.web.app, with no install: VS Code in the page, tests run in the browser, and you can sign in with Google to keep your progress on every device. Sign out any time and your progress stays on that device. See docs/DEPLOY.md and docs/ARCHITECTURE.md.
Choose what to learn. The first screen lets you pick topics and a target role, with how much of each you have finished. The Topics entry in the status bar reopens it at any time. Add a topic explains how to have a coding agent research and write one, then open a pull request.
Every card has a spoken script, but lessons ship no audio files. Install the Edge Read Aloud extension (sideload it) and it injects a speaker button into each narrated card, speaks the script live and lets you pick any Edge voice in one place. Without the extension the pages are plain text.
- Claude Code: the Ask Claude button (or
claudethen/tutor) opens a Socratic coach that reads your lesson, your code and your progress. It gives hints in steps, reviews against the project style, and runs mock interviews - Gemini Live: a voice tutor that watches your VS Code and talks you through it. Click Voice tutor in the VS Code status bar. It runs either on your own Gemini API key (no extension needed) or on your Gemini subscription through the
apps/gemini-liveChrome extension. See Gemini Live
The voice tutor talking through a lesson in real time:
2026-10-26.14-40-25.msedge.mp4
Warning
The subscription engine rides your Gemini subscription through Google's own web client, which Google doesn't offer for this use. Google may suspend or ban an account that uses it. If you'd rather not risk your account, use your own Gemini API key - the official, public Live API.
- Your API key (no extension): click Voice tutor in the status bar. The page that opens asks for a key once (create a free one in Google AI Studio) and keeps it in VS Code's secret storage. A
GEMINI_API_KEYenvironment variable, if set, takes precedence - Your Gemini subscription: sideload the extension (the same page walks you through it, or see its README). Once it is installed, its popup switches between the subscription and your API key
| Path | What |
|---|---|
curriculum/<track>/<NN-slug>/ |
lesson.md, starter/, solution/, tests/ |
curriculum/_kit/ |
helpers lessons share: implementation loading, Postgres (PGlite), fake LLM, mutation checks, seeded random, timing, bookstore Money |
curriculum/LEARNER.md |
who the course is written for |
curriculum/AUTHORING.md |
how to write a lesson (enforced by pnpm verify) |
curriculum/tracks.json, roles.json, path.json |
tracks, target roles and the study order |
work/ |
your copies of the exercises (git-ignored) |
.progress/ |
what you passed (git-ignored) |
scripts/ |
CLI (pnpm lesson), build, verify, start; scripts/lib holds the shared helpers |
apps/vscode-ext/ |
the VS Code extension |
apps/web/ |
the hosted version: VS Code in the browser, in-browser test runner, server and sign-in |
apps/gemini-live/ |
the Gemini Live bridge |
vendor/edge-tts-as-extension/ |
the voice tool (git submodule) |
pnpm lesson list | next | open <id> | test <id> | reset <id>
pnpm verify [track] # every solution passes, every starter fails, structure rules hold
pnpm typecheck # scripts, curriculum and every solution (run pnpm verify first)
pnpm dev # pnpm start that rebuilds on save, for working on the trainer itself
pnpm build # lessons -> dist/
pnpm deploy:web # build and release the hosted versionSome lessons are reading and quiz only (lang: none), such as the help desk lesson, and need no exercise.
- Short cards (130 words max), a picture on each, a voice that walks it: the course is built for someone who loses the thread in long text
- Every lesson names the rejected alternative and its cost, because interviews ask "why not X?"
- Every exercise ships a failing starter and a passing solution, checked by
pnpm verify, so a green test means something - SQL runs on real Postgres in-process (PGlite), AI exercises use a scripted fake model, so nothing needs a key or a network
The default order puts SQL first, then tests and APIs, then each role's branch. Change it in curriculum/path.json.
The course is data in curriculum/, so you can add lessons, tracks and roles, or retarget it to another job or subject, without touching the tooling.
- With a coding agent: ask it to extend the curriculum. Claude Code has the
/extend-curriculumskill, and other agents readAGENTS.md, which points to the same steps - By hand: follow
.claude/skills/extend-curriculum/SKILL.md, thencurriculum/AUTHORING.md.pnpm verifytells you when a lesson is right
Apache License 2.0. Copyright 2026 Avi.
You may use, change and share this project, including commercially. If you fork it or redistribute it, keep the NOTICE file and its credit to the original author, as section 4(d) of the license requires, and mark the files you changed.
