agent-cli 0.65.1__py3-none-any.whl → 0.66.1__py3-none-any.whl

agent_cli/install/extras.py

@@ -0,0 +1,119 @@
+"""Install optional extras at runtime with pinned versions."""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+from agent_cli.cli import app
+from agent_cli.core.utils import console, print_error_message
+
+# Extra name -> description mapping (used for docs generation)
+EXTRAS: dict[str, str] = {
+    "rag": "RAG proxy (ChromaDB, embeddings)",
+    "memory": "Long-term memory proxy",
+    "vad": "Voice Activity Detection (silero-vad)",
+    "whisper": "Local Whisper ASR (faster-whisper)",
+    "whisper-mlx": "MLX Whisper for Apple Silicon",
+    "tts": "Local Piper TTS",
+    "tts-kokoro": "Kokoro neural TTS",
+    "server": "FastAPI server components",
+    "speed": "Audio speed adjustment (audiostretchy)",
+}
+
+
+def _requirements_dir() -> Path:
+    return Path(__file__).parent.parent / "_requirements"
+
+
+def _available_extras() -> list[str]:
+    """List available extras based on requirements files."""
+    req_dir = _requirements_dir()
+    if not req_dir.exists():
+        return []
+    return sorted(p.stem for p in req_dir.glob("*.txt"))
+
+
+def _requirements_path(extra: str) -> Path:
+    return _requirements_dir() / f"{extra}.txt"
+
+
+def _in_virtualenv() -> bool:
+    """Check if running inside a virtual environment."""
+    return sys.prefix != sys.base_prefix
+
+
+def _install_cmd() -> list[str]:
+    """Build the install command with appropriate flags."""
+    in_venv = _in_virtualenv()
+    if shutil.which("uv"):
+        cmd = ["uv", "pip", "install", "--python", sys.executable]
+        if not in_venv:
+            # Allow installing to system Python when not in a venv
+            cmd.append("--system")
+        return cmd
+    cmd = [sys.executable, "-m", "pip", "install"]
+    if not in_venv:
+        # Install to user site-packages when not in a venv
+        cmd.append("--user")
+    return cmd
+
+
+@app.command("install-extras", rich_help_panel="Installation")
+def install_extras(
+    extras: Annotated[list[str] | None, typer.Argument(help="Extras to install")] = None,
+    list_extras: Annotated[
+        bool,
+        typer.Option("--list", "-l", help="List available extras"),
+    ] = False,
+    all_extras: Annotated[
+        bool,
+        typer.Option("--all", "-a", help="Install all available extras"),
+    ] = False,
+) -> None:
+    """Install optional extras (rag, memory, vad, etc.) with pinned versions.
+
+    Examples:
+        agent-cli install-extras rag           # Install RAG dependencies
+        agent-cli install-extras memory vad    # Install multiple extras
+        agent-cli install-extras --list        # Show available extras
+        agent-cli install-extras --all         # Install all extras
+
+    """
+    available = _available_extras()
+
+    if list_extras:
+        console.print("[bold]Available extras:[/]")
+        for name in available:
+            desc = EXTRAS.get(name, "")
+            console.print(f"  [cyan]{name}[/]: {desc}")
+        return
+
+    if all_extras:
+        extras = available
+
+    if not extras:
+        print_error_message("No extras specified. Use --list to see available, or --all.")
+        raise typer.Exit(1)
+
+    invalid = [e for e in extras if e not in available]
+    if invalid:
+        print_error_message(f"Unknown extras: {invalid}. Use --list to see available.")
+        raise typer.Exit(1)
+
+    cmd = _install_cmd()
+
+    for extra in extras:
+        req_file = _requirements_path(extra)
+        console.print(f"Installing [cyan]{extra}[/]...")
+        result = subprocess.run([*cmd, "-r", str(req_file)], check=False)
+        if result.returncode != 0:
+            print_error_message(f"Failed to install '{extra}'")
+            raise typer.Exit(1)
+
+    console.print("[green]Done![/]")

{agent_cli-0.65.1.dist-info → agent_cli-0.66.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.65.1
+Version: 0.66.1
 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>
@@ -231,6 +231,7 @@ The setup scripts automatically install:
     - [Alternative Local LLM Servers](#alternative-local-llm-servers)
 - [Usage](#usage)
   - [Installation Commands](#installation-commands)
+    - [Installing Optional Extras](#installing-optional-extras)
   - [Configuration](#configuration)
     - [Managing Configuration](#managing-configuration)
     - [Provider Defaults](#provider-defaults)
@@ -446,10 +447,62 @@ These commands help you set up `agent-cli` and its required services:
 
 - **`install-services`**: Install all required AI services (Ollama, Whisper, Piper, OpenWakeWord)
 - **`install-hotkeys`**: Set up system-wide hotkeys for quick access to agent-cli features
+- **`install-extras`**: Install optional Python dependencies (rag, memory, vad, etc.) with pinned versions
 - **`start-services`**: Start all services in a Zellij terminal session
 
 All necessary scripts are bundled with the package, so you can run these commands immediately after installing `agent-cli`.
 
+#### Installing Optional Extras
+
+Some features require additional Python dependencies. Use `install-extras` to install them with pinned versions:
+
+```bash
+# List available extras
+agent-cli install-extras --list
+
+# Install specific extras
+agent-cli install-extras rag memory vad
+```
+
+<details>
+<summary>See the output of <code>agent-cli install-extras --help</code></summary>
+
+<!-- CODE:BASH:START -->
+<!-- echo '```yaml' -->
+<!-- export NO_COLOR=1 -->
+<!-- export TERM=dumb -->
+<!-- export COLUMNS=90 -->
+<!-- export TERMINAL_WIDTH=90 -->
+<!-- agent-cli install-extras --help -->
+<!-- echo '```' -->
+<!-- CODE:END -->
+<!-- OUTPUT:START -->
+<!-- ⚠️ This content is auto-generated by `markdown-code-runner`. -->
+```yaml
+
+ Usage: agent-cli install-extras [OPTIONS] [EXTRAS]...
+
+ Install optional extras (rag, memory, vad, etc.) with pinned versions.
+
+ Examples: agent-cli install-extras rag           # Install RAG dependencies agent-cli
+ install-extras memory vad    # Install multiple extras agent-cli install-extras --list
+ # Show available extras agent-cli install-extras --all         # Install all extras
+
+╭─ Arguments ────────────────────────────────────────────────────────────────────────────╮
+│   extras      [EXTRAS]...  Extras to install                                           │
+╰────────────────────────────────────────────────────────────────────────────────────────╯
+╭─ Options ──────────────────────────────────────────────────────────────────────────────╮
+│ --list  -l        List available extras                                                │
+│ --all   -a        Install all available extras                                         │
+│ --help  -h        Show this message and exit.                                          │
+╰────────────────────────────────────────────────────────────────────────────────────────╯
+
+```
+
+<!-- OUTPUT:END -->
+
+</details>
+
 ### Configuration
 
 All `agent-cli` commands can be configured using a TOML file. The configuration file is searched for in the following locations, in order:

{agent_cli-0.65.1.dist-info → agent_cli-0.66.1.dist-info}/RECORD

@@ -2,14 +2,24 @@ agent_cli/__init__.py,sha256=-bo57j_5TsCug2tGHh7wClAGDhzN239639K40pgVh4g,187
 agent_cli/__main__.py,sha256=2wx_SxA8KRdejM-hBFLN8JTR2rIgtwnDH03MPAbJH5U,106
 agent_cli/_tools.py,sha256=u9Ww-k-sbwFnMTW8sreFGd71nJP6o5hKcM0Zd_D9GZk,12136
 agent_cli/api.py,sha256=FQ_HATc7DaedbEFQ275Z18wV90tkDByD_9x_K0wdSLQ,456
-agent_cli/cli.py,sha256=OsjgqoWkxafbNbugzULv1dJLyAZcxPZ_9wnZ22BdIN8,2731
+agent_cli/cli.py,sha256=zCk7sVVZstTU3GHFXAavcXd8Kactav4x0PyVY_rX4SI,2739
 agent_cli/config.py,sha256=dgwDV6chrQzGnVZIJ0OOg26jFKLCGIInC4Q9oXcj3rM,15413
 agent_cli/config_cmd.py,sha256=Fb-KBjtveft3x3_xjqlqobBwZqtI6Umrd8YzlwTAnZ4,9554
 agent_cli/constants.py,sha256=-Q17N6qKIGqPDsu3FxpIKP33G0Cs0RUJlHwYNHxVxek,843
-agent_cli/docs_gen.py,sha256=24NDnKcxdz0EarpuoIVtd0AeLIT8CTku5GLeAJRUyg8,14444
+agent_cli/docs_gen.py,sha256=n6QMPFZK0prpz2cGgo2yXX_I29p-l0jPGEbHZDZ-NUc,14809
 agent_cli/example-config.toml,sha256=xd9BXeOqdYx4xFJt58VBs2I49ESy6dF4-mWF_g8sM9o,7552
 agent_cli/opts.py,sha256=qMK_mLxzGAbX7C2IYuCFvOkLgaxCCMO66I9ps8AdrYo,12114
 agent_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agent_cli/_requirements/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agent_cli/_requirements/memory.txt,sha256=LmX0uKxnKuLTcZg5TESJ4n7AWrar7iMspONskvyiDTY,8860
+agent_cli/_requirements/rag.txt,sha256=e45zy2Xn6csCd0qJuuHYkMgNQXPgNHk6SElz8LtezC0,9656
+agent_cli/_requirements/server.txt,sha256=DbgthcQ2CufWaaFu-spq9Ow14rqdT5XO05licQNoeMA,5127
+agent_cli/_requirements/speed.txt,sha256=U1sdmglUJxhg_ZmxPc-iaJ38dpt5xP6sLG8CVnSDeyY,3642
+agent_cli/_requirements/tts-kokoro.txt,sha256=3BooGvCXgub0y2olZuoeOkoL-xyvU9WzYw9CaWRmZGE,10848
+agent_cli/_requirements/tts.txt,sha256=wqefgl9Amh3xsVLJHJPbtgJUpPZqf6lr9zuC6jjTEU8,5569
+agent_cli/_requirements/vad.txt,sha256=-nyWylzzLYyC0fBONsZf6HUhqkXxb2WsKpZlueFmwyg,6195
+agent_cli/_requirements/whisper-mlx.txt,sha256=sE229FmA91RACIEMG2cMNiWcsawbXvbglit8I395f_Q,7096
+agent_cli/_requirements/whisper.txt,sha256=CKgk5iOjB4MMKor4eCcrhTDkDJbYMbQXU-TfZHeVWKA,6283
 agent_cli/agents/__init__.py,sha256=c1rnncDW5pBvP6BiLzFVpLWDNZzFRaUA7-a97avFVAs,321
 agent_cli/agents/_voice_agent_common.py,sha256=PUAztW84Xf9U7d0C_K5cL7I8OANIE1H6M8dFD_cRqps,4360
 agent_cli/agents/assistant.py,sha256=BMF693kUZxM7u7mcI0nVua0EpqFcGlby2cMMZeLT7hY,13965
@@ -76,8 +86,9 @@ agent_cli/dev/terminals/registry.py,sha256=B27XjELpinLLf2PmwWxpAmnXf6KEXan4d2FDw
 agent_cli/dev/terminals/tmux.py,sha256=IciviwSoIb_KfKgS1q8iq_cK5iRgoz8vZuoNLAvcKJg,1498
 agent_cli/dev/terminals/warp.py,sha256=j-Jvz_BbWYC3QfLrvl4CbDh03c9OGRFmuCzjyB2udyo,4294
 agent_cli/dev/terminals/zellij.py,sha256=GnQnopimb9XH67CZGHjnbVWpVSWhaLCATGJizCT5TkY,2321
-agent_cli/install/__init__.py,sha256=wWv8GkkCy-WyI9QqctwwIE82J9kbMjSk3OWuxu_r2L0,114
+agent_cli/install/__init__.py,sha256=JQPrOrtdNd1Y1NmQDkb3Nmm1qdyn3kPjhQwy9D8ryjI,124
 agent_cli/install/common.py,sha256=WvnmcjnFTW0d1HZrKVGzj5Tg3q8Txk_ZOdc4a1MBFWI,3121
+agent_cli/install/extras.py,sha256=qdj3NjdzJrgA5gE0MzQUEdxBve0L1I5dxTmC2-527YI,3755
 agent_cli/install/hotkeys.py,sha256=bwGoPeEKK6VI-IrKU8Q0RLMW9smkDNU7CdqD3Nbsd-w,1626
 agent_cli/install/services.py,sha256=2s_7ThxaElKCuomBYTn4Z36TF_o_arNeyJ4f8Wh4jEI,2912
 agent_cli/memory/__init__.py,sha256=Q9lomqabThXFx-j_Yu3xKDyKLN4Odck92J6WDP53yUI,610
@@ -173,8 +184,8 @@ agent_cli/services/asr.py,sha256=V6SV-USnMhK-0aE-pneiktU4HpmLqenmMb-jZ-_74zU,169
 agent_cli/services/llm.py,sha256=Kwdo6pbMYI9oykF-RBe1iaL3KsYrNWTLdRSioewmsGQ,7199
 agent_cli/services/tts.py,sha256=exKo-55_670mx8dQOzVSZkv6aWYLv04SVmBcjOlD458,14772
 agent_cli/services/wake_word.py,sha256=j6Z8rsGq_vAdRevy9fkXIgLZd9UWfrIsefmTreNmM0c,4575
-agent_cli-0.65.1.dist-info/METADATA,sha256=ykG3jy2UI4XUvEk0VMnRJvbDXeJRnow_pXetASZ7hrg,152627
-agent_cli-0.65.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-agent_cli-0.65.1.dist-info/entry_points.txt,sha256=FUv-fB2atLsPUk_RT4zqnZl1coz4_XHFwRALOKOF38s,97
-agent_cli-0.65.1.dist-info/licenses/LICENSE,sha256=majJU6S9kC8R8bW39NVBHyv32Dq50FL6TDxECG2WVts,1068
-agent_cli-0.65.1.dist-info/RECORD,,
+agent_cli-0.66.1.dist-info/METADATA,sha256=WvTItFU9nOIQicSgJ_t2HbbCOuYfb6tJ3ONIk3l7VHg,155374
+agent_cli-0.66.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_cli-0.66.1.dist-info/entry_points.txt,sha256=FUv-fB2atLsPUk_RT4zqnZl1coz4_XHFwRALOKOF38s,97
+agent_cli-0.66.1.dist-info/licenses/LICENSE,sha256=majJU6S9kC8R8bW39NVBHyv32Dq50FL6TDxECG2WVts,1068
+agent_cli-0.66.1.dist-info/RECORD,,