---
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 with Wyoming protocol |
| `llm` | LLM framework (pydantic-ai) |
| `memory` | Long-term memory proxy |
| `rag` | RAG proxy (ChromaDB, embeddings) |
| `server` | FastAPI server components |
| `speed` | Audio speed adjustment (audiostretchy) |
| `piper` | Local Piper TTS |
| `kokoro` | Kokoro neural TTS |
| `vad` | Voice Activity Detection (silero-vad) |
| `faster-whisper` | Whisper ASR (CUDA/CPU) |
| `mlx-whisper` | Whisper ASR (Apple Silicon) |

<!-- OUTPUT:END -->

## Options

| Option | Description |
|--------|-------------|
| `--list`, `-l` | List available extras |
| `--all`, `-a` | Install all available extras |
| `--help`, `-h` | Show help for the command |

## 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
```
