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