agent-cli 0.68.0__tar.gz → 0.68.2__tar.gz

{agent_cli-0.68.0 → agent_cli-0.68.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.68.0
+Version: 0.68.2
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>

{agent_cli-0.68.0 → agent_cli-0.68.2}/agent_cli/install/extras.py

@@ -6,6 +6,7 @@ import shutil
 import subprocess
 import sys
 import tomllib
+from importlib.metadata import version as get_version
 from pathlib import Path
 from typing import Annotated
 
@@ -61,8 +62,9 @@ def _get_current_uv_tool_extras() -> list[str]:
 
 def _install_via_uv_tool(extras: list[str]) -> bool:
     """Reinstall agent-cli via uv tool with the specified extras."""
+    current_version = get_version("agent-cli").split("+")[0]  # Strip local version
     extras_str = ",".join(extras)
-    package_spec = f"agent-cli[{extras_str}]"
+    package_spec = f"agent-cli[{extras_str}]=={current_version}"
     python_version = f"{sys.version_info.major}.{sys.version_info.minor}"
     console.print(f"Reinstalling via uv tool: [cyan]{package_spec}[/] (Python {python_version})")
     cmd = ["uv", "tool", "install", package_spec, "--force", "--python", python_version]

{agent_cli-0.68.0 → agent_cli-0.68.2}/agent_cli/server/cli.py

@@ -20,13 +20,13 @@ console = Console()
 err_console = Console(stderr=True)
 logger = logging.getLogger(__name__)
 
-# Check for optional dependencies
-HAS_UVICORN = find_spec("uvicorn") is not None
-HAS_FASTAPI = find_spec("fastapi") is not None
-HAS_FASTER_WHISPER = find_spec("faster_whisper") is not None
-HAS_MLX_WHISPER = find_spec("mlx_whisper") is not None
-HAS_PIPER = find_spec("piper") is not None
-HAS_KOKORO = find_spec("kokoro") is not None
+# Check for optional dependencies at call time (not module load time)
+# This is important because auto-install may install packages after the module is loaded
+
+
+def _has(package: str) -> bool:
+    return find_spec(package) is not None
+
 
 app = typer.Typer(
     name="server",
@@ -48,7 +48,7 @@ def server_callback(ctx: typer.Context) -> None:
 
 def _check_server_deps() -> None:
     """Check that server dependencies are available."""
-    if not HAS_UVICORN or not HAS_FASTAPI:
+    if not _has("uvicorn") or not _has("fastapi"):
         err_console.print(
             "[bold red]Error:[/bold red] Server dependencies not installed. "
             "Run: [cyan]pip install agent-cli\\[server][/cyan] "
@@ -62,7 +62,7 @@ def _check_tts_deps(backend: str = "auto") -> None:
     _check_server_deps()
 
     if backend == "kokoro":
-        if not HAS_KOKORO:
+        if not _has("kokoro"):
             err_console.print(
                 "[bold red]Error:[/bold red] Kokoro backend requires kokoro. "
                 "Run: [cyan]pip install agent-cli\\[tts-kokoro][/cyan] "
@@ -72,7 +72,7 @@ def _check_tts_deps(backend: str = "auto") -> None:
         return
 
     if backend == "piper":
-        if not HAS_PIPER:
+        if not _has("piper"):
             err_console.print(
                 "[bold red]Error:[/bold red] Piper backend requires piper-tts. "
                 "Run: [cyan]pip install agent-cli\\[tts][/cyan] "
@@ -82,7 +82,7 @@ def _check_tts_deps(backend: str = "auto") -> None:
         return
 
     # For auto, check if either is available
-    if not HAS_PIPER and not HAS_KOKORO:
+    if not _has("piper") and not _has("kokoro"):
         err_console.print(
             "[bold red]Error:[/bold red] No TTS backend available. "
             "Run: [cyan]pip install agent-cli\\[tts][/cyan] for Piper "
@@ -136,7 +136,7 @@ def _check_whisper_deps(backend: str, *, download_only: bool = False) -> None:
     """Check that Whisper dependencies are available."""
     _check_server_deps()
     if download_only:
-        if not HAS_FASTER_WHISPER:
+        if not _has("faster_whisper"):
             err_console.print(
                 "[bold red]Error:[/bold red] faster-whisper is required for --download-only. "
                 "Run: [cyan]pip install agent-cli\\[whisper][/cyan] "
@@ -146,7 +146,7 @@ def _check_whisper_deps(backend: str, *, download_only: bool = False) -> None:
         return
 
     if backend == "mlx":
-        if not HAS_MLX_WHISPER:
+        if not _has("mlx_whisper"):
             err_console.print(
                 "[bold red]Error:[/bold red] MLX Whisper backend requires mlx-whisper. "
                 "Run: [cyan]pip install mlx-whisper[/cyan]",
@@ -154,7 +154,7 @@ def _check_whisper_deps(backend: str, *, download_only: bool = False) -> None:
             raise typer.Exit(1)
         return
 
-    if not HAS_FASTER_WHISPER:
+    if not _has("faster_whisper"):
         err_console.print(
             "[bold red]Error:[/bold red] Whisper dependencies not installed. "
             "Run: [cyan]pip install agent-cli\\[whisper][/cyan] "

{agent_cli-0.68.0 → agent_cli-0.68.2}/docs/architecture/index.md

@@ -141,22 +141,39 @@ Usage: [rag-proxy command](../commands/rag-proxy.md).
 
 ## Dependencies
 
+Agent CLI uses a modular dependency structure. The base package is lightweight, with features installed as optional extras.
+
 ### Core Dependencies
 
+Always installed:
+
 - **typer** - CLI framework
-- **pydantic-ai-slim** - AI agent framework with tool support
-- **sounddevice** - Audio I/O
-- **pyperclip** - Clipboard access
+- **pydantic** - Data validation
 - **rich** - Terminal formatting
-- **wyoming** - Protocol for local AI services
-- **openai** - OpenAI-compatible API client
-- **google-genai** - Google Gemini API client
+- **pyperclip** - Clipboard access
+- **httpx** - HTTP client
+
+### Provider Extras
+
+Install with `agent-cli install-extras <name>` or `pip install agent-cli[name]`:
+
+| Extra | Purpose | Key Packages |
+|-------|---------|--------------|
+| `audio` | Voice features | sounddevice, wyoming, numpy |
+| `llm` | AI processing | pydantic-ai-slim (OpenAI, Gemini) |
+
+### Feature Extras
 
-### Optional Dependencies
+| Extra | Purpose | Key Packages |
+|-------|---------|--------------|
+| `vad` | Voice activity detection | silero-vad |
+| `rag` | Document chat | chromadb, markitdown |
+| `memory` | Long-term memory | chromadb |
+| `server` | Local ASR/TTS servers | fastapi |
+| `faster-whisper` | Whisper (CUDA/CPU) | faster-whisper |
+| `mlx-whisper` | Whisper (Apple Silicon) | mlx-whisper |
 
-- **silero-vad** - Voice activity detection (for `transcribe-daemon`)
-- **chromadb** - Vector database (for RAG and memory)
-- **markitdown** - Document parsing (for RAG)
+See [`install-extras`](../commands/install-extras.md) for the full list and installation instructions.
 
 ## Platform Support
 

{agent_cli-0.68.0 → agent_cli-0.68.2}/zensical.toml

@@ -49,6 +49,7 @@ nav = [
     ] },
     { "Setup" = [
       { "config" = "commands/config.md" },
+      { "install-extras" = "commands/install-extras.md" },
       { "install-services" = "commands/install-services.md" },
       { "install-hotkeys" = "commands/install-hotkeys.md" },
       { "start-services" = "commands/start-services.md" },