install-extras
June 4, 2026 · View on GitHub
Install optional Python dependencies with pinned versions.
Usage
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:
| 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 |
nemo-whisper | Whisper-compatible ASR via NVIDIA NeMo (Parakeet) |
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 |
Options
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 |
Examples
# 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
NeMo / Parakeet
Use the runtime installer for NVIDIA NeMo support:
agent-cli install-extras nemo-whisper wyoming
agent-cli server whisper --backend nemo
This matters on Python 3.14. Plain pip install "agent-cli[nemo-whisper]" uses
the published extra metadata, while agent-cli install-extras nemo-whisper can
apply agent-cli's temporary uv override for the pinned NeMo Git build.