Back to directory

bloomtutor

In a curated listMaintenance: Active

li-evan/bloomtutor

Turns DSH into a personal tutor: builds a syllabus, teaches one adaptive lesson at a time and adapts the next lesson from the learner's notes.

View on GitHubHomepage
$ dsh plugin --profile web add bloomtutor-dsh

323

stars

43

forks

Python

Language

MIT

License

2026-03-10

Created

2026-11-17

Last push

MIT adaptive tutor for DSH — bloom-tutor plus learn-* skills via the bloomtutor-dsh npm package or the GitHub source.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-20

License

MIT

01What can it help you accomplish?

  • Learn any topic with adaptive one-on-one tutoring inside DeepSeek Harness

    A reviewable syllabus, lessons delivered one at a time, then evaluation and a course summary shaped by your highlights and feedback

    Learners who want a Socratic tutor in the terminal without running the separate web stack

  • Pick a portable learning skill for deep dives, analogies or quick ROI checks

    The bloom-tutor skill plus learn-deep, learn-crossover, learn-occam, learn-graph, learn-prototype and learn-feynman workflows

    Power users who already use DSH for agent work and want copyable study skills in the same session

  • Start a course from a stated learning goal in the CLI

    Bloom asks clarifying questions, designs an outline at your chosen depth, then begins lesson 1 after you approve the outline

    Self-directed learners who prefer Markdown project folders over the browser UI

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness CLI (`dsh`) with the web profile available on your machine

Installation steps

  1. 01

    Run `dsh plugin --profile web add bloomtutor-dsh` to install from npm

    $ dsh plugin --profile web add bloomtutor-dsh

  2. 02

    Alternatively run `dsh plugin --profile web add github:Li-Evan/BloomTutor` to add straight from this repository

    $ dsh plugin --profile web add github:Li-Evan/BloomTutor

  3. 03

    In DSH, ask the agent to `Create a new folder and help me learn [any topic]` to start the tutoring flow

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

The repo publishes the `bloomtutor-dsh` npm package; add it with `dsh plugin --profile web` to load bloom-tutor and the learn-* skills in DeepSeek Harness.

  • bloom-tutor interactive course

    a learning topic or goal in the agent chat→syllabus, adaptive lessons, evaluation and a course summary

    writes and updates lesson files in the project folder you create
  • Adaptive next lesson

    highlights, questions and feedback from the lesson you just read→a new lesson that reviews your answers, answers highlights and follows your style requests

    reads your prior lesson notes and feedback before generating the next lesson
  • learn-* study lenses

    a concept or field you name in chat→targeted flows such as deep dive, crossover analogy, Occam ROI check, knowledge graph, prototype build or Feynman explanation

  • Outline review before lesson 1

    Bloom's proposed course outline→an outline you can edit or redirect before the first lesson starts

  • Teaching style presets

    course-level teaching instructions→lessons rendered with concise, analogy, rigorous or custom teaching presets

04Who is it for? When not to use it?

Good for

  • Learners who want a Socratic tutor in the terminal without running the separate web stack
  • Power users who already use DSH for agent work and want copyable study skills in the same session
  • Self-directed learners who prefer Markdown project folders over the browser UI

Not for

  • The DSH package is CLI skills only; the full visual web tutor is a separate self-hosted Next.js + FastAPI app with its own Python, Node and API-key setup.

05Compatibility, maintenance and safety notes

  • The DSH package is CLI skills only; the full visual web tutor is a separate self-hosted Next.js + FastAPI app with its own Python, Node and API-key setup.
  • CLI Quick Start requires only Claude Code (or DeepSeek Harness in the DSH plugin path) and explicitly needs no Bloom backend.
  • The self-hosted web app expects you to supply an OpenAI-compatible chat-model API key in `.env` alongside Python, Node and uv/pnpm.
  • CLI mode keeps course files in folders you create locally; the self-hosted web app stores courses in your SQLite or Postgres database with no built-in accounts.
  • PDF page-to-Markdown reading in the web app is marked experimental and needs an optional vision model.
2026-03-102026-11-17Not specified by the author

MIT · last push 2026-11-17 · no GitHub release tagged

06Frequently asked questions

How do I install BloomTutor in DeepSeek Harness?

Run `dsh plugin --profile web add bloomtutor-dsh` from npm, or `dsh plugin --profile web add github:Li-Evan/BloomTutor` from the repository. See `integrations/deepseek-harness` in the repo for plugin details.

Does CLI mode through DSH need the Python or Next.js backend?

No. CLI mode runs as portable skills in the agent; the README lists only Claude Code for the manual copy path and needs no backend. The DSH plugin bundles the same skill folders.

Which skills ship with the DSH plugin?

The plugin bundle includes bloom-tutor plus the learn-deep, learn-crossover, learn-occam, learn-graph, learn-prototype and learn-feynman skills described in the Skills table.

When should I use DSH CLI instead of the web app?

The README positions CLI for terminal and Markdown-editor users via Claude Code or DeepSeek Harness, and Web for visual learners who self-host the browser app with their own materials and PDFs.

How does the next lesson change after I read a lesson?

Each adaptive lesson reviews your answers to the prior lesson's questions, answers what you highlighted and follows feedback such as shorter explanations or more examples before moving on.

08Data and sources

  • Author-claimedgithub.com5f13f54d1243…

    The same folders also run in DeepSeek Harness through the `bloomtutor-dsh` plugin.

  • Author-claimedgithub.com5f13f54d1243…

    dsh plugin --profile web add bloomtutor-dsh

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-20. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.