Free, open-source 11+ exam preparation to help your child get into grammar school.
Mac / Linux:
curl -fsSL https://raw.githubusercontent.com/jhammant/11plus-tutor/main/scripts/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/jhammant/11plus-tutor/main/scripts/install.ps1 | iexNo AI/LLM required - all 1,382 questions work immediately!
11+ tutoring costs £40-80/hour. Practice books cost £10-15 each and run out quickly. Many families can't afford proper preparation, putting their children at a disadvantage.
This tool is free, unlimited, and runs entirely on your computer.
| Subject | Questions | Coverage |
|---|---|---|
| Verbal Reasoning | 541 | Synonyms, antonyms, analogies, letter sequences, code words, odd one out, hidden words, compound words |
| Mathematics | 366 | Number sequences, arithmetic, fractions |
| Non-Verbal Reasoning | 300 | Pattern sequences, shape analogies, odd one out (all with SVG graphics) |
| English | 175 | Reading comprehension (Aesop's Fables), spelling, grammar |
- Programmatic questions are mathematically verified (sequences, arithmetic)
- Word-based questions validated against curated word lists
- All questions pass automated testing before release
- Wrong answer? Report it and we'll fix it immediately
- Topic Lessons - Understand concepts before practicing
- Strategy Guides - Step-by-step approaches for each question type
- Worked Examples - Detailed explanations for every answer
- Mock Exams - Timed practice under exam conditions
Mac / Linux:
curl -fsSL https://raw.githubusercontent.com/jhammant/11plus-tutor/main/scripts/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/jhammant/11plus-tutor/main/scripts/install.ps1 | iexThe installer will:
- ✅ Check for Python & Node.js (help you install if missing)
- ✅ Download 11+ Tutor
- ✅ Set up everything automatically
- ✅ Create a simple
start.shorstart.batto launch anytime
No LLM required! All 1,382 questions work immediately.
If you prefer to install manually:
# 1. Download the code
git clone https://github.com/jhammant/11plus-tutor.git
cd 11plus-tutor
# 2. Set up Python
python3 -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
# 3. Set up the website
cd web && npm install && cd ..
# 4. Start the app
python scripts/start_app.pyOpen http://localhost:3783 in your browser. That's it!
Run 11+ Tutor in a Docker container - no need to install Python or Node.js locally.
Build and run with Docker Compose (recommended):
# Clone the repository
git clone https://github.com/jhammant/11plus-tutor.git
cd 11plus-tutor
# Build and start the container
docker compose up -dOr use the build script:
# Build the Docker image
./scripts/build_docker.sh
# Run the container
docker run -d -p 3783:3783 -p 8002:8002 --name 11plus-tutor 11plus-tutorOr build manually:
docker build -t 11plus-tutor .
docker run -d -p 3783:3783 -p 8002:8002 --name 11plus-tutor 11plus-tutorOpen http://localhost:3783 in your browser.
Docker commands:
docker compose up -d # Start the container
docker compose down # Stop the container
docker compose logs -f # View logsNo! The app works perfectly without any LLM. All 1,382 questions are pre-generated and stored in the database.
| Feature | Without LLM | With LLM |
|---|---|---|
| Practice all questions | ✅ | ✅ |
| Mock exams with timer | ✅ | ✅ |
| Progress tracking | ✅ | ✅ |
| Strategy guides | ✅ | ✅ |
| Achievements & streaks | ✅ | ✅ |
| Printable worksheets | ✅ | ✅ |
| AI Tutor chat | ❌ | ✅ |
| "Explain this answer" | ❌ | ✅ |
| Generate new questions | ❌ | ✅ |
Recommendation: Start without an LLM. Add one later if you want AI explanations.
Just run the app! Everything works out of the box.
python scripts/start_app.pyRun AI on your own computer. Requires 8GB+ RAM.
Using LM Studio (Easiest):
- Download LM Studio (free)
- Download a model (search "llama 3.2" or "mistral")
- Click "Start Server" (default port 1234)
- Create
.envfile:
LLM_BINDING=openai
LLM_HOST=http://localhost:1234/v1
LLM_MODEL=local-model
LLM_API_KEY=lm-studio- Restart the app
Using Ollama:
# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh # Mac/Linux
# Windows: download from ollama.ai
# Get a model (3B is light, 8B is smarter)
ollama pull llama3.2 # 3B model, works on most machines
# OR
ollama pull llama3.1:8b # 8B model, needs 16GB RAM
# Create .env file
LLM_BINDING=ollama
LLM_HOST=http://localhost:11434/v1/
LLM_MODEL=llama3.2
LLM_API_KEY=ollamaUse OpenAI, Anthropic, or other cloud providers. Costs ~$0.01-0.05 per AI interaction.
OpenAI:
# Create .env file
LLM_BINDING=openai
LLM_HOST=https://api.openai.com/v1
LLM_MODEL=gpt-4o-mini
LLM_API_KEY=sk-your-api-key-hereAnthropic Claude:
# Create .env file
LLM_BINDING=openai
LLM_HOST=https://api.anthropic.com/v1
LLM_MODEL=claude-3-haiku-20240307
LLM_API_KEY=sk-ant-your-api-key-hereGroq (Free Tier Available):
# Create .env file
LLM_BINDING=openai
LLM_HOST=https://api.groq.com/openai/v1
LLM_MODEL=llama-3.1-8b-instant
LLM_API_KEY=gsk_your-api-key-here| Option | Cost | Speed | Privacy | Requires |
|---|---|---|---|---|
| No LLM | Free | N/A | Perfect | Nothing |
| LM Studio | Free | Varies | Perfect | 8GB+ RAM |
| Ollama | Free | Varies | Perfect | 8GB+ RAM |
| OpenAI | ~$0.01/use | Fast | Data sent | API key |
| Groq | Free tier | Very fast | Data sent | API key |
- Learn (5 min) - Read the topic lesson for one question type
- Strategy (5 min) - Review the strategy guide with your child
- Practice (15 min) - Do 10-15 questions with instant feedback
- Review (5 min) - Go over any wrong answers together
- Use the Mock Exam feature for timed practice
- Simulates real exam pressure
- Identifies weak areas to focus on
- The app tracks questions attempted and accuracy
- Focus on question types with lower scores
- Aim for 80%+ accuracy before moving on
| Type | Example | What It Tests |
|---|---|---|
| Synonyms | happy = joyful | Vocabulary |
| Antonyms | hot ≠ cold | Vocabulary |
| Analogies | cat:kitten :: dog:? | Relationships |
| Letter Sequences | AB, CD, EF, ? | Pattern recognition |
| Hidden Words | COST + AGE = STAGE | Word finding |
| Compound Words | SUN + FLOWER = ? | Word building |
| Type | What It Tests |
|---|---|
| Pattern Sequences | Shape rotation, size changes |
| Shape Analogies | "A is to B as C is to ?" |
| Odd One Out | Which shape doesn't belong |
| Type | Topics |
|---|---|
| Number Sequences | Arithmetic, quadratic patterns |
| Arithmetic | Addition, subtraction, multiplication, division |
| Fractions | Basic fraction operations |
| Type | Content |
|---|---|
| Comprehension | Aesop's Fables with questions |
| Spelling | Commonly misspelled words |
| Grammar | Fill-in-the-blank sentences |
Need more practice? Generate unlimited questions:
source venv/bin/activate
# Generate 100 more math sequences
python scripts/generate_questions.py --type sequences --count 100
# Generate 50 more NVR questions
python scripts/generate_nvr.py --type all --count 50
# Generate more VR questions
python scripts/generate_vr_expanded.py --count 100
# Validate all questions
python scripts/validate_questions.pyEvery contribution helps a child. See CONTRIBUTING.md for details.
- Report wrong answers - Open an issue with the question ID
- Add word pairs - Expand synonym/antonym lists
- Suggest passages - Find public domain text for comprehension
- Add question types - CEM format, more NVR types
- Improve UI - Mobile responsiveness, accessibility
- Add features - Printable worksheets, progress export
python scripts/test_harness.py # Should show 57/57 passing- CEM-style questions (different from GL Assessment)
- Cube nets (which cube from this net?)
- Paper folding (punch and unfold)
- 3D rotation
- Cloze passages (fill in blanks)
- Shuffled sentences
- Docker for one-command setup
- Printable worksheet generator
- Mobile app (React Native?)
- Spaced repetition scheduling
- Parent dashboard with reports
| Board | Status | Notes |
|---|---|---|
| GL Assessment | Good | Most question types covered |
| CEM | Partial | Need more cloze/comprehension |
| ISEB | Partial | Similar to GL |
Different regions use different tests. Check which board your target schools use.
Q: Is this as good as a tutor? A: No substitute for a good tutor, but this provides unlimited free practice. Many families use both.
Q: Are the answers definitely correct? A: Programmatic questions (maths, sequences) are computed and guaranteed correct. Word-based questions are validated against curated lists. Report any errors immediately.
Q: My child is struggling with [X]. What should I do? A: Focus on that topic using the filters. Read the strategy guide together. Do 10 questions, review wrong answers, repeat.
Q: Can I use this offline? A: Yes, once installed everything runs locally. No internet needed.
Q: Is my child's data sent anywhere? A: No. Everything stays on your computer. We don't collect any data.
MIT License - free for everyone, forever.
- Built with Next.js, FastAPI, Tailwind CSS
- AI features via LM Studio or Ollama
- Comprehension passages from Aesop's Fables (public domain)
Made with love to help every child have a fair chance at grammar school.
If this helped your child, consider starring the repo and sharing with other parents.