100yenadmin / fish-audio-hermes

# Fish Audio for Hermes
**The official Fish Audio plugin for Hermes Agent,
maintained by Electric Sheep.**
Give your agent a voice: expressive speech in 80+ languages, Fish Audio's library of community voices, your own
cloned or designed voices, and accurate speech-to-text. It works in the Hermes CLI, every messaging app Hermes
supports and the Desktop app.
 [code] 
This installs the reviewed release pinned in the Hermes plugin catalog. To follow the repository's latest `main` instead:
 [code] 
On Hermes 0.21.6 and newer, Hermes asks before installing the plugin's Python dependencies; in a script, add
`--yes-deps`. Hermes 0.21.5 installs them without asking and has no `--yes-deps` flag. On either version,
`hermes plugins enable fish-audio` afterwards also installs them.
`hermes fish login` checks the key against your Fish account and saves it to the active profile. It makes Fish
Audio the speech and transcription provider where none is set, and replaces another provider only if you confirm
at the prompt or pass `--yes`. Once Fish Audio is the provider, voice replies,
read-aloud and voice notes go through it.
## What you get
| | |
|---|---|
| **Expressive speech** | Fish Audio S2 models follow emotion and delivery cues such as `[excited]`, `[whispering]` and `[laughing]`. Drama 3 (`drama-3`) takes plain-language direction and word-level tags such as ` … `. Multi-speaker dialogue and custom pronunciations are supported too. |
| **Streaming voice** | CLI voice mode and Desktop voice replies stream each sentence as it is ready. In our tests the first audio bytes arrived 0.24–0.38 s after a sentence was sent (see Streaming voice for how this was measured). |
| **Voice library** | Search Fish Audio's community voices from chat (`/fish voices narrator`) and switch with `/fish use `. |
| **Voice names** | Save a voice under a short name (`/fish alias add narrator `), then use the name wherever a voice id goes: `/fish use narrator`, `/fish preview narrator` or `fish_speak`. |
| **Your own voices** | Clone a voice from a short sample, or describe one in words and pick from the candidates. Cloning and deleting from chat go through Hermes's approval gate, so by default Hermes asks you first. |
| **Speech-to-text** | Voice notes use `transcribe-1-pro`. Live dictation shows phrases while you speak in CLI voice mode, TUI and Desktop (Hermes 0.21.6+). `fish_transcribe` adds speaker turns, timestamps and SRT subtitles. |
| **Desktop Voices page** | In Hermes Desktop: browse and preview voices, pick one for the agent, clone or design your own, and check your credit. |
| **Account at a glance** | `/fish balance` shows your API credit and plan. When credits run out, tools and `/fish` commands reply with a top-up link; for voice replies, `/fish status` shows the last error. |
## Setup
1. **Get a key** at . New accounts can start on Fish's free `s2.1-pro-free` model, free through 30 November 2026;
 after that, add API credit.
2. **Add it** with `hermes fish login` on