ielts-anything
v0.0.2
Published
IELTS Academic practice on any topic: Cambridge-format Reading, Listening, Writing and Speaking tests, written and marked by your Codex subscription.
Maintainers
Readme
be so fr, nobody locks in for a 900-word passage on soil erosion 🥀 and the listening where a guy spends four minutes getting a library card? we're cooked 😭
IELTS Anything writes the test about stuff you'd doomscroll anyway: football, K-pop, F1, whatever AI drama dropped this week. it's a real Cambridge-format paper, same question types, same timing, same FALSE vs NOT GIVEN spiral. the topic just isn't mid anymore ✌️
Quickstart ⚡
npx ielts-anythingIt opens in your browser. Type "a Listening test about my fave football club", go touch grass for a sec 🌱
What's free 💸
| | What you need | |---|---| | Reading and Writing | A free ChatGPT account. That's it, start today 🆓 | | Listening | Free too, with voices that run on your laptop. Plug in an OpenAI API key and the audio goes from "fine" to actually good 🎧 | | Speaking | ChatGPT Plus or above. The live voice examiner needs it 🎙️ |
no Plus and no API key? brokie behaviour fr 😭 Reading, Writing and Listening still work though, so no excuses.
What it does 👀
Ask for literally anything. Pick a topic and a skill. Full test or a quick drill, your call.
Reading 📖 Three passages, 40 questions. A second AI takes every test blind first and snitches on any dodgy question before you ever see it. The review shows exactly where each answer was hiding 🔍
Listening 🎧 Four fully voiced parts with a narrator, forms and maps. Exam mode plays once, zero mercy 💀 Practice mode lets you rewind as many times as your ego can handle.
Listening review 🔁 Tap a question and hear the exact second the answer flew past you. Painful. Educational. Mostly painful 😭
Writing ✍️ Charts, maps and process diagrams for Task 1. Essay questions you actually have takes on for Task 2.
Writing feedback 🧾 Marked against the official band descriptors, one criterion at a time, quoting your own sentences back at you. With love. Mostly 😏
Speaking 🎙️ A live interview with a voice examiner who asks about your interests, not your hometown's bus routes for the fifth time 🫠
Your tutor, in the chat 💬 Scores pop up right there. Ask "why was 7 wrong??" or "another one like that but harder" and it just does it.
Progress 📈 Your bands over time, plus which question type is your villain origin story.
Pick the voices 🗣️ Free voices that run on your laptop, or OpenAI's if you've got a key.
Install and nerd stuff 🤓
You need: Node.js 22.13+ and the Codex CLI, signed in with your ChatGPT account (codex login). A free account covers Reading, Writing and Listening; Speaking needs ChatGPT Plus or above. The app keeps its data in ~/.ielts-anything, away from your coding history.
Listening voices (Settings):
- Kokoro (default): free, runs locally, British and American voices. A 90 MB model downloads the first time.
- OpenAI: bring your own API key for
gpt-4o-mini-tts. Smoother voices, plus Australian and New Zealand accents, about 40 cents per full test 💸
How it works: Codex writes each test following the rulebooks in skills/, then publishes it through app tools that keep sending it back until it matches the Cambridge 12–21 format. packages/spec holds the schemas, checks and marking. Answers and scripts stay hidden on the server until you submit. No peeking 🙅
apps/server Codex bridge, app tools, marking, Listening audio
apps/web Chat, test screens, results, progress, settings
packages/spec Schemas, validators, marking (npm test)
skills The tutor's rulebooks and Writing reference drawings
research Format research and sourcesOptions: npx ielts-anything --port 9000 --no-open. Environment overrides: IELTS_HOME, IELTS_MODEL, IELTS_EFFORT, IELTS_VOICE, IELTS_EXAMINER_VOICE, PORT.
From source:
git clone https://github.com/RyanNg1403/ielts-anything.git
cd ielts-anything && npm install && npm run dev # http://127.0.0.1:5173npm test, npm run typecheck, npm run build (the npm package), and npx tsx apps/server/scripts/render-listening.ts to hear the voices.
Releasing: bump version in package.json and CHANGELOG.md, then push a matching tag (git tag v0.0.2 && git push origin v0.0.2). GitHub Actions tests, publishes to npm and creates the release.
The serious bit (sorry) 🧐 This is Cambridge-format practice, not official tests, and it isn't affiliated with IELTS, the British Council, IDP or Cambridge. The repo contains only counts, rules and paraphrases from studying Cambridge IELTS 12–21, never the books, passages, scripts or audio. Band scores are estimates: great for practice, not for your visa officer. MIT licence.
