---
icon: lucide/package-plus
---

# install-extras

Install optional Python dependencies with pinned versions.

## Usage

```bash
agent-cli install-extras [OPTIONS] [EXTRAS]...
```

## Description

Some agent-cli features require additional Python dependencies that are not installed by default. This command installs them with pinned versions from the project's lock file, ensuring reproducible installations.

This is functionally equivalent to `pip install agent-cli[extra]`, but with important advantages:
- **Pinned versions**: Uses exact versions from the project's lock file for reproducibility
- **Works post-install**: Install extras at runtime without reinstalling agent-cli
- **uv-aware**: Uses uv when available for faster installs, falls back to pip

Available extras:

<!-- CODE:START -->
<!-- from agent_cli.docs_gen import extras_table -->
<!-- print(extras_table()) -->
<!-- CODE:END -->
<!-- OUTPUT:START -->
<!-- ⚠️ This content is auto-generated by `markdown-code-runner`. -->
| Extra | Description |
|-------|-------------|
| `audio` | Audio recording/playback |
| `diarization` | Speaker diarization (pyannote.audio) |
| `faster-whisper` | Whisper ASR via CTranslate2 |
| `kokoro` | Kokoro neural TTS (GPU) |
| `llm` | LLM framework (pydantic-ai) |
| `memory` | Long-term memory proxy |
| `mlx-whisper` | Whisper ASR for Apple Silicon |
| `piper` | Piper TTS (CPU) |
| `rag` | RAG proxy (ChromaDB, embeddings) |
| `server` | FastAPI server components |
| `speed` | Audio speed adjustment (audiostretchy) |
| `vad` | Voice Activity Detection (Silero VAD via ONNX) |
| `vectordb` | Vector database with embeddings (ChromaDB) |
| `whisper-transformers` | Whisper ASR via HuggingFace transformers |
| `wyoming` | Wyoming protocol support |

<!-- OUTPUT:END -->

## Options

<!-- CODE:START -->
<!-- from agent_cli.docs_gen import all_options_for_docs -->
<!-- print(all_options_for_docs("install-extras")) -->
<!-- CODE:END -->
<!-- OUTPUT:START -->
<!-- ⚠️ This content is auto-generated by `markdown-code-runner`. -->
### Options

| Option | Default | Description |
|--------|---------|-------------|
| `--list, -l` | `false` | Show available extras with descriptions (what each one enables) |
| `--all, -a` | `false` | Install all available extras at once |


<!-- OUTPUT:END -->

## Examples

```bash
# List available extras
agent-cli install-extras --list

# Install a single extra
agent-cli install-extras vad

# Install multiple extras
agent-cli install-extras rag memory vad

# Install all extras
agent-cli install-extras --all
```
