dsh-tts

Text-to-speech for the DeepSeek Harness Web GUI. When Speak agent replies is on, each finished assistant turn is synthesized on the host and played in the browser. API keys never reach the browser.

A later messenger hub can call the same host chain (POST /dsh-tts/speak or the speak_text tool). This package does not talk to Telegram itself.

Install

# From npm (after a GitHub/npm release):
dsh plugin --profile web add @goodandready/dsh-tts

# From a local checkout:
dsh plugin --profile web add file:/path/to/dsh-tts

Restart the Web UI, then hard-refresh the browser.

Configure

Settings -> Speech:

• Speak agent replies -- off by default.
• Provider chain -- pick a provider, paste its API key in that row, then Save (or leave the key field). The value is written to the host credentials store immediately and is never sent back to the browser. The row shows Configured / Not set. Leave the field blank to keep an existing key. Local providers (edge, piper, espeak) have no key field.
• A provider without a credential is skipped, not fatal.
• Piper / eSpeak / edge-tts binaries and the Piper model path.

Keys land in the same store the rest of DSH uses (credentials file, then the process environment). The plugin stores names, never values:

OPENAI_API_KEY
ELEVENLABS_API_KEY
GEMINI_API_KEY
AZURE_SPEECH_KEY
GROQ_API_KEY
DEEPGRAM_API_KEY
OPENROUTER_API_KEY

Put additional keys in the same pool (<PROVIDER>_API_KEY_2, ...) if you use a key-rotation plugin.

Providers

| Key | Service | Default model / voice | Credential | |---|---|---|---| | openai | OpenAI Audio Speech | gpt-4o-mini-tts / alloy | OPENAI_API_KEY | | elevenlabs | ElevenLabs | eleven_multilingual_v2 | ELEVENLABS_API_KEY | | google | Gemini TTS | gemini-2.5-flash-preview-tts / Kore | GEMINI_API_KEY | | azure | Azure Speech | neural voice + region | AZURE_SPEECH_KEY + region | | groq | Groq PlayAI | playai-tts | GROQ_API_KEY | | deepgram | Deepgram Aura | aura-asteria-en | DEEPGRAM_API_KEY | | openrouter | OpenRouter /audio/speech | openai/gpt-4o-mini-tts-2025-12-15 | OPENROUTER_API_KEY | | edge | Microsoft Edge Neural via edge-tts CLI | ru-RU-SvetlanaNeural | none | | piper | local Piper | path to an ONNX model | none | | espeak | eSpeak NG | voice ru | none |

Default chain: edge → piper → espeak. Deepgram Aura does not list Russian; keep it below a Russian-capable voice if you speak Russian.

Free local / CLI providers

pip install edge-tts          # provides the `edge-tts` binary
# piper: install the Piper binary and point Settings at your .onnx model
sudo apt install espeak-ng    # or the equivalent package on your OS

Tool

speak_text(text) — synthesize with the same chain. The tool result is a short status line; it does not inject audio into the model history.

Routes

| Route | Purpose | |---|---| | GET /dsh-tts/status | chain and whether auto-speak is on | | GET or PUT /dsh-tts/config | settings plus configured/writable/ref per cloud provider. PUT may include keys; values are stored as credentials and never echoed. | | PUT or DELETE /dsh-tts/credential | writes or clears one host credential immediately | | GET /dsh-tts/pending?after= | audio produced for finished replies | | POST /dsh-tts/speak | {text} -> {ok, provider, mime, audioBase64} |

Requirements

• DeepSeek Harness with the Web GUI
• Node 20+
• Optional: edge-tts, piper, espeak-ng for the free providers

License

MIT