welsione/dsh-mmx-bridge

dsh-mmx-bridge

One tool = all MiniMax multimodal capabilities. Give DeepSeek Harness (DSH) the ability to see images, generate art, create videos, speak, sing, search the web, and more.

English · 中文 README

---

Why?

DSH is text-only by default — no images, no speech, no video. dsh-mmx-bridge plugs in MiniMax's full multimodal stack through a single mmx_bridge tool. Install once, get 8 capabilities:

v1.0.5+: just drop an image to send it — your input stays untouched. Dropping or pasting an image into the chat input works with text-only models: your message (image + prompt) is displayed and stored exactly as you wrote it. Behind the scenes the plugin lets it pass the model gate and, right before the LLM call, saves the image to a temp dir (default /tmp/mmx-out/) and replaces it with "image URL + local path" text — the Agent then automatically calls read_image / mmx_bridge(describe) to look at it. Models that genuinely support image input pass through untouched. Disable anytime from the plugin settings card.

Quick Start

Prerequisites

1. DSH v0.1.0-rc.7+
2. mmx-cli installed & logged in: npm i -g mmx-cli && mmx auth login

Install

dsh plugin --profile web add dsh-mmx-bridge

⚠️ npm unreachable? Use dsh plugin --profile web add github:welsione/dsh-mmx-bridge

Restart dsh after installing (server-side ESM cache does not hot-reload), then refresh the Web GUI. See AGENT.md for details.

Have your agent install it (paste this prompt to your agent)

Install the DSH plugin dsh-mmx-bridge for me (repo https://github.com/welsione/dsh-mmx-bridge ):

Run `dsh plugin --profile web add dsh-mmx-bridge` to install into the web GUI profile; if npm is unreachable, use `dsh plugin --profile web add github:welsione/dsh-mmx-bridge` instead. Verify the plugin is mounted after installing, then remind me to restart dsh (the settings-page card only appears after a restart).

Uninstall

dsh plugin --profile web rm dsh-mmx-bridge

Screenshots

Image generation	Speech synthesis

Image understanding (VLM)	Plugin settings

Architecture

User chat → DSH Agent → mmx_bridge tool → mmx-cli → MiniMax API
                                                  ↓
                                            /mmx-files/ (same-origin)
                                            (image preview / audio & video players)

• Zero npm runtime dependencies — Node.js builtins only
• Same-origin media — generated files served via /mmx-files/ with inline preview
• Web GUI enhancement — image preview, audio/video players, settings card auto-load

Compatibility

Item	Details
DSH version	0.1.0-rc.7+ (Web GUI profile)
Runtime deps	Zero npm deps (Node builtins)
External deps	mmx-cli (at call time)
OS	macOS / Linux / Windows (Node.js 18+)

FAQ

Verify DSH version ≥ 0.1.0-rc.7 and mmx-cli is installed (mmx --version). Refresh the Web GUI page.

Since DSH rc.7, the settings page dispatches cards by the server-registered settings namespace, so plugin ≥ 1.0.4 is required (1.0.4 registers the dsh-mmx-bridge namespace). Confirm the installed version is ≥ 1.0.4, restart dsh (server-side ESM cache does not hot-reload), then hard-refresh the Web GUI page.

Run mmx auth login first. If using Token Plan, ensure your subscription is active.

MiniMax video generation has queue limits;高峰期间 may take longer. Check mmx quota for balance.

Related

Project	Description
DeepSeek Harness	The DSH agent framework
MiniMax CLI	MiniMax official CLI
awesome-dsh-plugin	DSH plugin curated list (this plugin included)
dsh-recommend	DSH plugin rankings (this plugin included)

Contributing

PRs and issues welcome.

git clone https://github.com/welsione/dsh-mmx-bridge.git
cd dsh-mmx-bridge
npm install
npm run build
dsh plugin --profile web add .   # local install for testing

License

MIT

---