dsh-plugin-rapidspeech

English | 简体中文

Local, offline speech-to-text for the DeepSeek Harness (dsh). Click the microphone in the composer, speak, and the recognized text is inserted into your draft — transcribed by a RapidSpeech.cpp rs-server running on your own machine. Audio never leaves your computer.

Features

• Fully offline — audio, model inference, and transcripts stay on this machine end to end.
• Managed server — on first use, dsh downloads the rs-server binary and your chosen model, verifies their integrity, spawns the server on a loopback port, and reclaims it after idle time. No manual services.
• Model switching from the plugin page — pick a model in the plugin's settings; it downloads on the next recording and hot-swaps. Every downloaded model stays cached, so switching back is instant.
• Curated model catalog — X-ASR, SenseVoice, and FunASR-Nano from RapidAI's official mirrors (ModelScope, HuggingFace, hf-mirror), each pinned to a SHA-256.
• Coexists with other providers — installs beside the official SenseVoice plugin; pick a provider per recording from the voice-input selector.
• External mode — point the plugin at an rs-server you run yourself; the plugin then only connects and never manages it.

Requirements

• DeepSeek Harness 0.2.2 or newer (npm CLI or Desktop app)
• CPU with AVX2 — Intel Haswell (2013) / AMD Excavator (2015) or newer. Both the Linux and Windows builds target AVX2 as their baseline, so the requirement is identical on either OS.
• Disk: ~200 MB–1 GB per model; RAM: ~1–2 GB while transcribing
• Windows x64 and Linux x64

Install

From the plugin marketplace (Desktop / Web UI)

Two ways — both put RapidSpeech ASR (local) in your plugin list:

• Search and install (simplest): open the market's install page, search for dsh-plugin-rapidspeech, and install it. The package lives on the official npm registry; if your npm mirror lags behind, give it a few minutes or point the registry back at registry.npmjs.org.

• Index source (curated card with a description): add this index URL in the market's index settings, then find RapidSpeech ASR (local) and install:

  https://github.com/yoletPig/dsh-plugin-rapidspeech/releases/latest/download/market-index.json
  

From the CLI

dsh plugin --profile <your-profile> add dsh-plugin-rapidspeech

Or install a specific release artifact without any build tooling:

# Download dsh-plugin-rapidspeech-<version>.tgz from GitHub Releases, then:
dsh plugin --profile <your-profile> add ./dsh-plugin-rapidspeech-<version>.tgz

git clone https://github.com/yoletPig/dsh-plugin-rapidspeech.git
cd dsh-plugin-rapidspeech
npm install          # the prepare script builds lib/
dsh plugin --profile <your-profile> add ./dsh-plugin-rapidspeech

Quick start

1. Start dsh and open the composer.
2. Click the microphone, then Install when prompted — the rs-server binary and the model download in the background (one-time, ~180 MB for the default model).
3. Record. Stop, and the transcript appears in your draft, ready to edit and send.

The server reclaims itself after 5 idle minutes and wakes in about 2 seconds on the next recording.

Models

Switching models

Open the plugin's page in dsh and pick a model — the field is live: the next recording downloads it (after your consent) and subsequent recordings use it. All catalog models live in the same cache, so switching back to a previously downloaded model needs no download.

X-ASR is only published on ModelScope, so the HuggingFace mirror is not offered for it; choosing an unavailable mirror fails explicitly rather than falling back.

Advanced overrides

Set these in the plugin page or in your profile's cordis.patch.yml (precedence top to bottom):

• modelPath — use a local GGUF file directly.
• modelDownloadUrl — download from any HTTPS URL.
• modelId — a catalog entry.

Configuration

Troubleshooting

• Download fails with fetch failed — the host cannot reach the download origin. On Windows, native dsh does not read the system proxy; declare yours in %USERPROFILE%\.dsh\.env and restart dsh:

  HTTPS_PROXY=http://127.0.0.1:7897
  HTTP_PROXY=http://127.0.0.1:7897
  

  (Loopback traffic is always direct, so the local server is unaffected.)
• The server is blocked or silently killed — antivirus software may flag the unsigned binary. Whitelist the cache's bin/ directory.
• Unsupported RapidSpeech language — the selected model does not advertise the configured language; check the model table above.
• Linux Illegal instruction / Windows 0xC000001D — your CPU predates AVX2; releases target AVX2 as the minimum.
• WSL: the Web UI is unreachable from Windows — use the full token URL printed at startup, or bind the WSL address with --host.

License

This plugin is MIT licensed. Third-party components are used as follows: