install-extras

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

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.