by Li-Evan
Open-source AI tutor for personalized learning: Socratic, adaptive lessons to learn anything. Claude Code skill + self-hosted web app. Bloom 2 Sigma · 开源 AI 家教
# Add to your Claude Code skills
git clone https://github.com/Li-Evan/BloomTutorGuides for using ai agents skills like BloomTutor.
See how BloomTutor compares with popular alternatives.
BloomTutor is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Li-Evan. Open-source AI tutor for personalized learning: Socratic, adaptive lessons to learn anything. Claude Code skill + self-hosted web app. Bloom 2 Sigma · 开源 AI 家教. It has 310 GitHub stars.
BloomTutor's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/Li-Evan/BloomTutor" and add it to your Claude Code skills directory (see the Installation section above).
BloomTutor is primarily written in Python. It is open-source under Li-Evan on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh BloomTutor against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
In 1984, educational psychologist Benjamin Bloom discovered that students receiving one-on-one tutoring scored 2 standard deviations (+2σ) above the classroom average — jumping to the top 2%. Bloom called this the "2 Sigma Problem": the effect is proven, but personal tutors don't scale.
Bloom solves this with AI. It generates a structured syllabus, delivers lessons one at a time, reads your annotations and feedback, then tailors the next lesson to your exact understanding level — just like a real tutor would.
| Mode | Setup | Best for |
|---|---|---|
| CLI | Claude Code + terminal | Power users who like Markdown editors |
| Web | Browser (Next.js + FastAPI), self-hosted | Visual learners, your own materials and PDFs |
Both follow the same flow: syllabus → lesson → annotate → feedback → next lesson → evaluation → summary.
Requires only Claude Code. No backend.
git clone https://github.com/Li-Evan/BloomTutor.git
cd BloomTutor
# Install the tutor skill locally for this clone
mkdir -p .claude/skills
cp -R skills/bloom-tutor .claude/skills/
claude
Then say: Create a new folder and help me learn [any topic]
Or install it as a plugin (bundles bloom-tutor plus the learn-* skills) — in Claude Code:
/plugin marketplace add Li-Evan/BloomTutor
/plugin install bloom@li-evan
See GUIDE.md for the full walkthrough.
The web app is a self-hosted, single-user tutor: no accounts, no billing. You bring an API key for any OpenAI-compatible model; everything you create stays in your own database.
git clone https://github.com/Li-Evan/BloomTutor.git
cd BloomTutor
make setup # creates .env with a random BACKEND_JWT_SECRET, installs backend and frontend deps
# edit .env: fill in LLM_API_KEY, LLM_BASE_URL and LLM_MODEL
make dev-backend # terminal 1: runs the database migrations, then the API on 127.0.0.1:8000
make dev-frontend # terminal 2: the web app on http://localhost:3000
Open http://localhost:3000, click New course, and start learning.
make setup # or: cp .env.example .env and fill it in yourself
docker compose up -d --build # then open http://localhost:3000
Data lives in the bloom-storage volume (a SQLite database plus the images inside your materials). To use Postgres instead, set DATABASE_URL in .env.
| Variable | What it does |
|---|---|
LLM_API_KEY, LLM_BASE_URL, LLM_MODEL |
The model used for syllabi, lessons and answers |
LLM_FAST_MODEL |
Optional smaller model for the knowledge map, course placement and selection translation |
PDF_READING_MODEL |
Optional vision model for "PDF reading" (page images → Markdown) |
LLM_EXTRA_BODY |
JSON passed as extra_body on every call, e.g. {"thinking":{"type":"disabled"}} for DeepSeek |
BACKEND_JWT_SECRET |
Shared by the frontend server and the backend; the backend only accepts tokens signed with it |
DATABASE_URL |
Defaults to backend/storage/bloom.sqlite3 |
LANGFUSE_* |
Optional tracing of every model call to Langfuse |
Bloom has no login: anyone who can open the web app is you. Keep it on localhost, or put it behind something that authenticates (a VPN, Tailscale, or a reverse proxy with basic auth) before exposing it. The backend is never published by docker compose; it only answers requests signed with BACKEND_JWT_SECRET.
The web app was rebuilt on Next.js with a new database schema. The old bloom.db is not migrated; the new app starts with an empty database in backend/storage/.
Describe a goal (optionally upload materials) → Bloom asks a few clarifying questions
↓
Outline: what you will be able to do, in order → review / edit it
↓
Read lesson 1 → highlight and ask → write feedback → answer thought questions
↓
Click "Done reading" → the next lesson reviews your answers, answers your highlights,
follows your feedback and moves on
↓
Repeat until every mastery item is covered ✅ → evaluation → course summary
Upload files / a folder / a link / PDFs → each one becomes a page (no outline)
↓
Read → highlight and ask, or ask about the whole page → mark as read, archive
↓
What you read feeds the knowledge map and next-step suggestions
Ways to start a course
Learning
Seeing the whole
Bloom ships a set of portable Claude Code skills in skills/ — self-contained capability packs you can copy into ~/.claude/skills/ (global) or any project's .claude/skills/ and use anywhere.
| Skill | What it does |
|---|---|
| bloom-tutor | The full interactive tutoring system as one skill — syllabus → adaptive lessons → ??? annotations → evaluation → summary. CLI mode, packaged and portable. |
| learn-deep | Default deep-dive entry — runs all five lenses below in one pass, then helps you pick a direction |
| learn-crossover | Learn a new concept by leveraging what you already know (structural analogies) |
| learn-occam | Decide whether / how deeply something is worth learning (ROI, just-enough) |
| learn-graph | Build a knowledge-graph map of a field plus a learning path |
| learn-prototype | Learn by building the crappiest working prototype, then iterating |
| learn-feynman | Verify true understanding by explaining it back |
Each folder is dependency-free: c