THU-MAIC/dsh-openmaic
82Last commit Aug 13, 2026
dsh-openmaic DSH plugin
dsh-openmaic registers four tools and a Socratic teaching skill. It enables agents to generate lessons, render slides, interactive widgets, and inline HTML fragments using OpenMAIC's services. The plugin polls generation jobs asynchronously and returns playable links or sandboxed cards.
How to install the dsh-openmaic DSH plugin
dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.gitCopying does not run this command. Review the repository and version before installing the dsh-openmaic DSH plugin.
dsh-openmaic DSH plugin data source
dsh-openmaic DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-openmaic DSH plugin can do
- openmaic_generate: submits a lesson requirement to OpenMAIC, polls for async completion, and returns a playable classroom link.
- openmaic_slide: renders an OpenMAIC slide (PPTist-style Slide JSON) using the official renderer, supporting text, shapes, images, tables, charts, formulas, and code.
- openmaic_widget: renders an interactive widget (simulation, game, or code) that the agent writes as a full HTML document, streaming code while writing and rendering on completion.
- openmaic_render: renders an inline HTML teaching fragment (concept card, quiz, walkthrough) as a sandboxed card in the conversation.
- openmaic-teach skill: turns a session into a Socratic OpenMAIC lesson, teaching by guided questioning and pulling in slides, widgets, and cards as aids.
Where the dsh-openmaic DSH plugin fits
- A teacher asks the agent to create a beginner quantum physics lesson, and the plugin generates a classroom link.
- A student requests a projectile motion simulator, and the agent writes the widget code which is rendered interactively.
- An educator embeds an inline HTML concept card quiz into the chat for quick assessment.
- A developer uses the Socratic skill to guide a learner through a topic step by step.
Who the dsh-openmaic DSH plugin is for
- Educators creating interactive AI-powered lessons.
- AI agent developers who want to integrate OpenMAIC's teaching tools into DeepSeek Harness.
- Learners who benefit from conversational, Socratic-style teaching sessions.
dsh-openmaic DSH plugin limitations
- Generation jobs are asynchronous; the plugin polls until completion, with a maximum wait of 10 minutes (default 600000 ms).
- The slide, widget, and render tools only render content that the agent writes; they do not perform any server-side generation.
- The accessCode configuration is not yet enforced online, but may become required in the future.
dsh-openmaic DSH plugin: from the repository README
Quoted from the THU-MAIC/dsh-openmaic README, the upstream source of the dsh-openmaic DSH plugin. Copyright remains with the original authors.
把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek Harness. `dsh-openmaic` is a DeepSeek Harness plugin that registers four tools and a Socratic teaching skill: - `openmaic_generate`: tell your agent "make me a lesson about X", and the plugin submits the requirement to [open.maic.chat](https://open.maic.chat/), waits for the async generation job, and returns a playable classroom link. - `openmaic_slide`: the agent writes one OpenMAIC slide (PPTist-style Slide JSON) and the plugin renders it with OpenMAIC's official renderer (text, shapes, images, tables, charts, formulas, code). - `openmaic_widget`: the agent writes an OpenMAIC-style interactive widget (simulation, game, or code) per the bundled contract; the code streams as it writes, then renders inline as a sandboxed card. - `openmaic_render`: the agent writes an inline HTML teaching fragment (concept card, quiz, walkthrough) and the plugin renders it as a sandboxed card right in the conversation. - `openmaic-teach` skill: turns a session into a Socratic OpenMAIC lesson, teaching by guided questioning and pulling in slides, widgets, and cards as aids. ## What it looks like ``` 用户: 帮我做一节量子物理入门课 模型 → openmaic_generate
Read the full READMERepository license: MIT
dsh-openmaic DSH plugin questions
How do I install dsh-openmaic?
Run `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git` in your terminal. Then restart the `dsh web` service and refresh the browser. The plugin includes compiled files, so no separate build step is needed.
What tools does dsh-openmaic provide?
It provides four tools: `openmaic_generate` (generate a lesson classroom), `openmaic_slide` (render an OpenMAIC slide), `openmaic_widget` (render an interactive widget), and `openmaic_render` (render an inline HTML teaching fragment). It also includes a Socratic teaching skill called `openmaic-teach`.
Can I use dsh-openmaic with a local OpenMAIC instance?
Yes, you can set the `baseUrl` configuration option to `http://localhost:3000` (or your local server) to develop against a local OpenMAIC instance. The default is `https://open.maic.chat`.
How does openmaic_generate work?
The agent calls `openmaic_generate` with a lesson requirement. The plugin submits a POST request to OpenMAIC’s `/api/generate-classroom` endpoint, receives a job ID, and then polls the server until the job succeeds or fails (up to the configured `maxWaitMs`). On success, it returns a playable classroom link.
Does dsh-openmaic support server-side generation for slides and widgets?
No. The `openmaic_slide`, `openmaic_widget`, and `openmaic_render` tools only render content that the agent writes. They do not perform any server-side generation; they rely on the OpenMAIC SDK contracts (`@openmaic/dsl`, `@openmaic/generation`, `@openmaic/renderer`) to render the content inline.