Back to directory

dsh-openmaic

Curated pickMaintenance: Active

thu-maic/dsh-openmaic

OpenMAIC for DeepSeek Harness: classrooms, slides, interactive widgets, and Socratic teaching

View on GitHub
$ dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

83

stars

14

forks

JavaScript

Language

MIT

License

2026-08-13

Created

2026-08-13

Last push

A native DeepSeek Harness plugin that turns your agent into an OpenMAIC teacher — generating classrooms, slides, interactive widgets, and sandboxed teaching cards via four tools plus a Socratic skill.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-03

License

MIT

01What can it help you accomplish?

  • Build AI-generated classrooms and Socratic lessons inside DeepSeek Harness

    A playable classroom link on open.maic.chat, plus slides, interactive widgets, and inline teaching cards rendered in the conversation

    Educators, teachers, and agents running DeepSeek Harness who want interactive, Socratic teaching material

  • Render agent-authored slides, widgets, and HTML teaching fragments inline

    Sandboxed cards and official-renderer slides covering text, shapes, images, tables, charts, formulas, code, simulations, and games

    Developers and teaching agents who want visual, interactive courseware generated directly inside DeepSeek Harness

02How to install into DeepSeek Harness

Installation steps

  1. 01

    Run `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git` to install the plugin into the `web` profile.

    $ dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

  2. 02

    Restart `dsh web` and refresh the page — the plugin's compiled `lib/` is already shipped, so no build step is needed.

    $ dsh web

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DeepSeek Harness runtime plugin: installed via the official `dsh plugin --profile web add` command, it registers four tools and a Socratic teaching skill that run inside the harness.

  • openmaic_generate — classroom generation

    A lesson requirement (e.g. "make me a lesson about X") plus optional flags such as `language`→A playable classroom link on open.maic.chat, returned after an async generation job

  • openmaic_slide — slide rendering

    One OpenMAIC slide written as PPTist-style Slide JSON→A rendered slide via OpenMAIC's official renderer (text, shapes, images, tables, charts, formulas, code)

  • openmaic_widget — interactive widget

    An OpenMAIC-style interactive widget (simulation, game, or code) written against the bundled contract→A full HTML document rendered inline as a sandboxed card; code streams as the agent writes it

  • openmaic_render — inline HTML teaching card

    An inline HTML teaching fragment (concept card, quiz, walkthrough)→A sandboxed card rendered right in the conversation

  • openmaic-teach — Socratic teaching skill

    A DeepSeek Harness session→A Socratic OpenMAIC lesson that teaches by guided questioning, pulling in slides, widgets, and cards as aids

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

Good for

  • Educators, teachers, and agents running DeepSeek Harness who want interactive, Socratic teaching material
  • Developers and teaching agents who want visual, interactive courseware generated directly inside DeepSeek Harness

Not for

  • The slide / widget / render tools do no server-side generation; they render content the agent authors against the OpenMAIC SDK contracts (`@openmaic/dsl`, `@openmaic/generation`, `@openmaic/renderer`), shown inline as sandboxed cards.

05Compatibility, maintenance and safety notes

  • Generation tools submit requirements to and poll open.maic.chat remotely; classroom generation is async and depends on the external OpenMAIC service being reachable over the network.
  • The slide / widget / render tools do no server-side generation; they render content the agent authors against the OpenMAIC SDK contracts (`@openmaic/dsl`, `@openmaic/generation`, `@openmaic/renderer`), shown inline as sandboxed cards.
  • Classroom generation is slow; the default `pollIntervalMs` is 5000 but 60000 is friendlier, and a single job is capped at `maxWaitMs` = 600000 (10 minutes).
2026-08-132026-08-13Not specified by the author

MIT · maintained (latest release not published; tracked from default-branch commit)

06Frequently asked questions

How do I install dsh-openmaic into DeepSeek Harness?

Run `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git`, then restart `dsh web` and refresh. The plugin ships its compiled `lib/`, so a git install needs no build step.

What tools does the plugin register?

It registers four tools — `openmaic_generate`, `openmaic_slide`, `openmaic_widget`, `openmaic_render` — plus an `openmaic-teach` skill that runs a Socratic teaching session using those tools as aids.

Where is the classroom generated, and do I need an account?

`openmaic_generate` submits the requirement to open.maic.chat and polls for an async job, returning a playable classroom link. The `accessCode` invite field is not enforced online yet, so you can leave it empty for now.

Do the slide / widget / render tools need server-side generation?

No. Those tools do no server-side generation; they render content the agent authors against the OpenMAIC SDK contracts (`@openmaic/dsl`, `@openmaic/generation`, `@openmaic/renderer`), shown inline as sandboxed cards.

How do I point the plugin at a local OpenMAIC instance?

Set `baseUrl` to `http://localhost:3000` in the plugin config (`dsh-openmaic.baseUrl`). Other tunables include `pollIntervalMs` and `maxWaitMs` (the 10-minute cap for one generation job).

08Data and sources

  • Author-claimedgithub.com09c1693cfe83…

    `dsh-openmaic` is a DeepSeek Harness plugin that registers four tools

  • Author-claimedgithub.com09c1693cfe83…

    dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. 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.