elevenlabs-cli 0.1.8

Unofficial CLI for ElevenLabs text-to-speech API
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273

<h1 align="center">ElevenLabs CLI</h1>

<p align="center">
  The community-built command line for ElevenLabs AI audio workflows.
</p>

<p align="center">
  <a href="https://github.com/hongkongkiwi/elevenlabs-cli/releases">
    <img src="https://img.shields.io/github/v/release/hongkongkiwi/elevenlabs-cli?style=for-the-badge&logo=github&label=release" alt="GitHub Release" />
  </a>
  <a href="https://lib.rs/crates/elevenlabs-cli">
    <img src="https://img.shields.io/crates/v/elevenlabs-cli?style=for-the-badge&logo=rust" alt="Crates.io Version" />
  </a>
  <a href="https://lib.rs/crates/elevenlabs-cli">
    <img src="https://img.shields.io/crates/d/elevenlabs-cli?style=for-the-badge&logo=rust" alt="Crates.io Downloads" />
  </a>
  <a href="https://github.com/hongkongkiwi/elevenlabs-cli/actions/workflows/ci.yml">
    <img src="https://img.shields.io/github/actions/workflow/status/hongkongkiwi/elevenlabs-cli/ci.yml?branch=main&style=for-the-badge&logo=github&label=ci" alt="CI" />
  </a>
  <a href="https://opensource.org/licenses/MIT">
    <img src="https://img.shields.io/badge/license-MIT-3DA639?style=for-the-badge" alt="MIT License" />
  </a>
</p>

<p align="center">
  <a href="https://github.com/hongkongkiwi/action-elevenlabs-cli/blob/main/README.md">
    <img src="https://img.shields.io/badge/github-action-2088FF?style=flat-square&logo=githubactions&logoColor=white" alt="GitHub Action" />
  </a>
  <a href="https://github.com/hongkongkiwi/homebrew-elevenlabs-cli/blob/main/README.md">
    <img src="https://img.shields.io/badge/homebrew-tap-FBB040?style=flat-square&logo=homebrew&logoColor=black" alt="Homebrew Tap" />
  </a>
  <a href="https://github.com/hongkongkiwi/scoop-elevenlabs-cli/blob/main/README.md">
    <img src="https://img.shields.io/badge/scoop-bucket-4A89DC?style=flat-square" alt="Scoop Bucket" />
  </a>
  <a href="https://github.com/hongkongkiwi/elevenlabs-cli/pkgs/container/elevenlabs-cli">
    <img src="https://img.shields.io/badge/docker-ghcr-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker GHCR" />
  </a>
  <a href="https://github.com/hongkongkiwi/elevenlabs-cli-skill/blob/main/README.md">
    <img src="https://img.shields.io/badge/ai%20skill-clawhub-7A5AF8?style=flat-square" alt="ClawHub Skill" />
  </a>
</p>

<p align="center">
  <a href="#installation">Install</a>
  ·
  <a href="#quick-start">Quick Start</a>
  ·
  <a href="#common-workflows">Workflows</a>
  ·
  <a href="#mcp-server-mode">MCP</a>
  ·
  <a href="#ecosystem">Ecosystem</a>
  ·
  <a href="#support">Support</a>
</p>

> [!WARNING]
> This is an independent, community-built CLI and is not an official ElevenLabs release. For official platform docs, visit [elevenlabs.io/docs](https://elevenlabs.io/docs).

## Why ElevenLabs CLI

- Unified interface for TTS, STT, voice cloning, dubbing, and audio tooling
- Script-friendly output (`--json`) for automation and CI pipelines
- MCP server mode for AI assistants with tool filtering and safety controls
- Multi-channel distribution (Homebrew, Scoop, Cargo, Docker, source)

## Installation

| Channel | Command |
| --- | --- |
| Homebrew (macOS/Linux) | `brew tap hongkongkiwi/elevenlabs-cli && brew install elevenlabs-cli` |
| Scoop (Windows) | `scoop bucket add elevenlabs-cli https://github.com/hongkongkiwi/scoop-elevenlabs-cli && scoop install elevenlabs-cli` |
| Cargo (all platforms) | `cargo install elevenlabs-cli` |
| Cargo with MCP feature | `cargo install elevenlabs-cli --features mcp` |
| Docker | `docker run --rm -e ELEVENLABS_API_KEY=your-key ghcr.io/hongkongkiwi/elevenlabs-cli tts "Hello"` |
| From source | `git clone https://github.com/hongkongkiwi/elevenlabs-cli.git && cd elevenlabs-cli && cargo install --path .` |

## Quick Start

```bash
# 1) Set API key (or use: elevenlabs-cli config set api_key "..." )
export ELEVENLABS_API_KEY="your-api-key"

# 2) Generate speech
elevenlabs-cli tts "Hello from ElevenLabs CLI" --output hello.mp3

# 3) List voices
elevenlabs-cli voice list

# 4) Transcribe audio
elevenlabs-cli stt audio.mp3
```

> [!TIP]
> Examples use `elevenlabs-cli` (the default binary name). If you want a shorter command, add an alias such as `alias elevenlabs='elevenlabs-cli'`.

## Feature Surface

| Area | Commands |
| --- | --- |
| Speech | `tts`, `tts-stream`, `tts-timestamps`, `realtime-tts`, `stt` |
| Voice | `voice`, `voice-changer`, `voice-design`, `library`, `samples`, `pronunciation` |
| Content | `sfx`, `dialogue`, `music`, `dub`, `isolate`, `audio-native` |
| Agent Platform | `agent`, `converse`, `tools`, `projects`, `knowledge`, `rag`, `workspace` |
| Platform Ops | `history`, `usage`, `models`, `user`, `config`, `webhook`, `update`, `interactive` |
| Developer UX | `completions`, global `--json`, optional `mcp` mode |

## Common Workflows

### Text to Speech

```bash
elevenlabs-cli tts "Ship high-quality audio from the terminal" --voice Brian --output narration.mp3
```

### Speech to Text with Speaker Diarization

```bash
elevenlabs-cli stt meeting.mp3 --diarize --num-speakers 3
```

### Voice Cloning

```bash
elevenlabs-cli voice clone --name "My Voice" --samples voice1.mp3,voice2.mp3
```

### Sound Effects

```bash
elevenlabs-cli sfx "A soft UI notification" --duration 3 --output notification.mp3
```

### JSON for Automation

```bash
elevenlabs-cli --json voice list | jq '.[0].voice_id'
```

## MCP Server Mode

Start the server:

```bash
elevenlabs-cli mcp
```

> [!NOTE]
> `mcp` is available in builds that include the `mcp` feature (for example, `cargo install elevenlabs-cli --features mcp`).

Minimal client config:

```json
{
  "mcpServers": {
    "elevenlabs": {
      "command": "elevenlabs-cli",
      "args": ["mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key"
      }
    }
  }
}
```

Security options:

```bash
elevenlabs-cli mcp --enable-tools tts,stt,voice
elevenlabs-cli mcp --disable-admin
elevenlabs-cli mcp --disable-destructive
elevenlabs-cli mcp --read-only
```

## Configuration

Default config path: `~/.config/elevenlabs-cli/config.toml`

```toml
api_key = "your-api-key"
default_voice = "Brian"
default_model = "eleven_multilingual_v2"
default_output_format = "mp3_44100_128"

[mcp]
enable_tools = "tts,stt"
disable_tools = "agents"
disable_admin = false
read_only = false
```

## Available Models

| Model | Best For |
| --- | --- |
| `eleven_multilingual_v2` | High quality synthesis across many languages |
| `eleven_flash_v2_5` | Lowest latency |
| `eleven_turbo_v2_5` | Balanced speed and quality |
| `eleven_v3` | Expressive and emotional speech |
| `scribe_v1` | Higher-accuracy speech-to-text |
| `scribe_v1_base` | Faster, lower-cost speech-to-text |

## Output Formats

| Format | Use Case |
| --- | --- |
| `mp3_44100_128` | Default, broadly compatible |
| `mp3_44100_192` | Higher quality MP3 |
| `wav_44100` | Editing and mastering |
| `pcm_16000` | Telephony and real-time systems |
| `opus_48000_128` | Streaming and WebRTC |
| `ulaw_8000` | Legacy telephony |

## Command Reference

Use `elevenlabs-cli --help` and `elevenlabs-cli <command> --help` for details.

| Command | Description |
| --- | --- |
| `tts` | Text-to-speech synthesis |
| `stt` | Speech-to-text transcription |
| `voice` | Voice management (list, clone, edit, delete) |
| `library` | Shared/community voice library |
| `isolate` | Background-noise removal |
| `voice-changer` | Speech-to-speech voice transformation |
| `dub` | Dubbing and translation workflows |
| `dialogue` | Multi-speaker dialogue generation |
| `sfx` | Sound effect generation |
| `music` | Music generation |
| `agent`, `converse`, `tools`, `projects` | Conversational/agent features |
| `knowledge`, `rag`, `workspace` | Knowledge and workspace management |
| `history`, `usage`, `models`, `user` | Account/model/runtime information |
| `config`, `webhook`, `update`, `interactive`, `completions` | Tooling and operations |
| `mcp` | Model Context Protocol server mode |

## Ecosystem

Companion repositories and their README files:

| Repository | Purpose | README |
| --- | --- | --- |
| [hongkongkiwi/action-elevenlabs-cli](https://github.com/hongkongkiwi/action-elevenlabs-cli) | GitHub Action wrapper for CI workflows | [Open](https://github.com/hongkongkiwi/action-elevenlabs-cli/blob/main/README.md) |
| [hongkongkiwi/homebrew-elevenlabs-cli](https://github.com/hongkongkiwi/homebrew-elevenlabs-cli) | Homebrew tap for releases | [Open](https://github.com/hongkongkiwi/homebrew-elevenlabs-cli/blob/main/README.md) |
| [hongkongkiwi/scoop-elevenlabs-cli](https://github.com/hongkongkiwi/scoop-elevenlabs-cli) | Scoop bucket for Windows installs | [Open](https://github.com/hongkongkiwi/scoop-elevenlabs-cli/blob/main/README.md) |
| [hongkongkiwi/elevenlabs-cli-skill](https://github.com/hongkongkiwi/elevenlabs-cli-skill) | AI-agent skill integration | [Open](https://github.com/hongkongkiwi/elevenlabs-cli-skill/blob/main/README.md) |

## Resources

- [ElevenLabs API Reference](https://elevenlabs.io/docs/api-reference)
- [ElevenLabs Documentation](https://elevenlabs.io/docs)
- [Voice Library](https://elevenlabs.io/app/voice-library)
- [API Keys](https://elevenlabs.io/app/settings/api-keys)
- [Status Page](https://status.elevenlabs.io)

## Support

- [Report a bug](https://github.com/hongkongkiwi/elevenlabs-cli/issues)
- [Request a feature](https://github.com/hongkongkiwi/elevenlabs-cli/issues)
- [Releases](https://github.com/hongkongkiwi/elevenlabs-cli/releases)

## Contributing

Contributions are welcome.

1. Fork the repository.
2. Create a feature branch.
3. Run tests and checks.
4. Open a pull request with context and examples.

## License

MIT License. See [LICENSE](LICENSE).