agent-cli 0.61.2__py3-none-any.whl → 0.70.2__py3-none-any.whl

agent_cli/_requirements/vad.txt

@@ -0,0 +1,155 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --extra vad --no-dev --no-emit-project --no-hashes
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.12.1
+    # via httpx
+certifi==2026.1.4
+    # via
+    #   httpcore
+    #   httpx
+click==8.3.1
+    # via
+    #   typer
+    #   typer-slim
+colorama==0.4.6 ; sys_platform == 'win32'
+    # via click
+coloredlogs==15.0.1
+    # via onnxruntime
+dotenv==0.9.9
+    # via agent-cli
+filelock==3.20.3
+    # via torch
+flatbuffers==25.12.19
+    # via onnxruntime
+fsspec==2026.1.0
+    # via torch
+h11==0.16.0
+    # via httpcore
+httpcore==1.0.9
+    # via httpx
+httpx==0.28.1
+    # via agent-cli
+humanfriendly==10.0
+    # via coloredlogs
+idna==3.11
+    # via
+    #   anyio
+    #   httpx
+jinja2==3.1.6
+    # via torch
+markdown-it-py==4.0.0
+    # via rich
+markupsafe==3.0.3
+    # via jinja2
+mdurl==0.1.2
+    # via markdown-it-py
+mpmath==1.3.0
+    # via sympy
+networkx==3.6.1
+    # via torch
+numpy==2.3.5
+    # via onnxruntime
+nvidia-cublas-cu12==12.8.4.1 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via
+    #   nvidia-cudnn-cu12
+    #   nvidia-cusolver-cu12
+    #   torch
+nvidia-cuda-cupti-cu12==12.8.90 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cuda-nvrtc-cu12==12.8.93 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cuda-runtime-cu12==12.8.90 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cudnn-cu12==9.10.2.21 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cufft-cu12==11.3.3.83 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cufile-cu12==1.13.1.3 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-curand-cu12==10.3.9.90 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cusolver-cu12==11.7.3.90 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-cusparse-cu12==12.5.8.93 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via
+    #   nvidia-cusolver-cu12
+    #   torch
+nvidia-cusparselt-cu12==0.7.1 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-nccl-cu12==2.27.5 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-nvjitlink-cu12==12.8.93 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via
+    #   nvidia-cufft-cu12
+    #   nvidia-cusolver-cu12
+    #   nvidia-cusparse-cu12
+    #   torch
+nvidia-nvshmem-cu12==3.3.20 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+nvidia-nvtx-cu12==12.8.90 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+onnxruntime==1.20.1
+    # via silero-vad
+packaging==25.0
+    # via
+    #   onnxruntime
+    #   silero-vad
+protobuf==6.33.4
+    # via onnxruntime
+psutil==7.2.1 ; sys_platform == 'win32'
+    # via agent-cli
+pydantic==2.12.5
+    # via agent-cli
+pydantic-core==2.41.5
+    # via pydantic
+pygments==2.19.2
+    # via rich
+pyperclip==1.11.0
+    # via agent-cli
+pyreadline3==3.5.4 ; sys_platform == 'win32'
+    # via humanfriendly
+python-dotenv==1.2.1
+    # via dotenv
+rich==14.2.0
+    # via
+    #   agent-cli
+    #   typer
+    #   typer-slim
+setproctitle==1.3.7
+    # via agent-cli
+setuptools==80.9.0 ; python_full_version >= '3.12'
+    # via torch
+shellingham==1.5.4
+    # via
+    #   typer
+    #   typer-slim
+silero-vad==6.2.0
+    # via agent-cli
+sympy==1.14.0
+    # via
+    #   onnxruntime
+    #   torch
+torch==2.9.1
+    # via
+    #   silero-vad
+    #   torchaudio
+torchaudio==2.9.1
+    # via silero-vad
+triton==3.5.1 ; platform_machine == 'x86_64' and sys_platform == 'linux'
+    # via torch
+typer==0.21.1
+    # via agent-cli
+typer-slim==0.21.1
+    # via agent-cli
+typing-extensions==4.15.0
+    # via
+    #   anyio
+    #   pydantic
+    #   pydantic-core
+    #   torch
+    #   typer
+    #   typer-slim
+    #   typing-inspection
+typing-inspection==0.4.2
+    # via pydantic

agent_cli/agents/assistant.py

@@ -41,6 +41,7 @@ from agent_cli.agents._voice_agent_common import (
 from agent_cli.cli import app
 from agent_cli.core import audio, process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     InteractiveStopEvent,
     maybe_live,
@@ -253,7 +254,8 @@ async def _async_main(
                 print_with_style("✨ Ready for next command...", style="green")
 
 
-@app.command("assistant")
+@app.command("assistant", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def assistant(
     *,
     # --- Provider Selection ---

agent_cli/agents/autocorrect.py

@@ -9,11 +9,11 @@ import sys
 import time
 from typing import TYPE_CHECKING
 
-import pyperclip
 import typer
 
 from agent_cli import config, opts
 from agent_cli.cli import app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     console,
     create_status,
@@ -117,6 +117,8 @@ def _display_result(
 ) -> None:
     """Handle output and clipboard copying based on desired verbosity."""
     if clipboard:
+        import pyperclip  # noqa: PLC0415
+
         pyperclip.copy(corrected_text)
 
     if simple_output:
@@ -208,7 +210,8 @@ async def _async_autocorrect(
         sys.exit(1)
 
 
-@app.command("autocorrect")
+@app.command("autocorrect", rich_help_panel="Text Commands")
+@requires_extras("llm")
 def autocorrect(
     *,
     text: str | None = typer.Argument(

agent_cli/agents/chat.py

@@ -29,6 +29,7 @@ from agent_cli._tools import tools
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     InteractiveStopEvent,
     console,
@@ -373,7 +374,8 @@ async def _async_main(
         raise
 
 
-@app.command("chat")
+@app.command("chat", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def chat(
     *,
     # --- Provider Selection ---

agent_cli/agents/memory/__init__.py

@@ -10,11 +10,12 @@ from agent_cli.core.process import set_process_title
 memory_app = typer.Typer(
     name="memory",
     help="Memory system operations (add, proxy, etc.).",
+    add_completion=True,
     rich_markup_mode="markdown",
     no_args_is_help=True,
 )
 
-app.add_typer(memory_app, name="memory")
+app.add_typer(memory_app, name="memory", rich_help_panel="Servers")
 
 
 @memory_app.callback()

agent_cli/agents/memory/add.py

@@ -13,6 +13,7 @@ import typer
 
 from agent_cli import opts
 from agent_cli.agents.memory import memory_app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import console, print_command_line_args
 
 if TYPE_CHECKING:
@@ -110,6 +111,7 @@ def _write_memories(
 
 
 @memory_app.command("add")
+@requires_extras("memory")
 def add(
     memories: list[str] = typer.Argument(  # noqa: B008
         None,

agent_cli/agents/memory/proxy.py

@@ -10,10 +10,12 @@ from rich.logging import RichHandler
 
 from agent_cli import constants, opts
 from agent_cli.agents.memory import memory_app
-from agent_cli.core.utils import console, print_command_line_args, print_error_message
+from agent_cli.core.deps import requires_extras
+from agent_cli.core.utils import console, print_command_line_args
 
 
 @memory_app.command("proxy")
+@requires_extras("memory")
 def proxy(
     memory_path: Path = typer.Option(  # noqa: B008
         "./memory_db",
@@ -103,17 +105,10 @@ def proxy(
     if print_args:
         print_command_line_args(locals())
 
-    try:
-        import uvicorn  # noqa: PLC0415
-
-        from agent_cli.memory._files import ensure_store_dirs  # noqa: PLC0415
-        from agent_cli.memory.api import create_app  # noqa: PLC0415
-    except ImportError as exc:
-        print_error_message(
-            "Memory dependencies are not installed. Please install with "
-            "`pip install agent-cli[memory]` or `uv sync --extra memory`.",
-        )
-        raise typer.Exit(1) from exc
+    import uvicorn  # noqa: PLC0415
+
+    from agent_cli.memory._files import ensure_store_dirs  # noqa: PLC0415
+    from agent_cli.memory.api import create_app  # noqa: PLC0415
 
     logging.basicConfig(
         level=log_level.upper(),

agent_cli/agents/rag_proxy.py

@@ -10,6 +10,7 @@ from rich.logging import RichHandler
 
 from agent_cli import constants, opts
 from agent_cli.cli import app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     console,
     print_command_line_args,
@@ -17,7 +18,8 @@ from agent_cli.core.utils import (
 )
 
 
-@app.command("rag-proxy")
+@app.command("rag-proxy", rich_help_panel="Servers")
+@requires_extras("rag")
 def rag_proxy(
     docs_folder: Path = typer.Option(  # noqa: B008
         "./rag_docs",
@@ -75,16 +77,9 @@ def rag_proxy(
     logging.getLogger("chromadb").setLevel(logging.WARNING)
     logging.getLogger("uvicorn.access").setLevel(logging.WARNING)
 
-    try:
-        import uvicorn  # noqa: PLC0415
+    import uvicorn  # noqa: PLC0415
 
-        from agent_cli.rag.api import create_app  # noqa: PLC0415
-    except ImportError as exc:
-        print_error_message(
-            "RAG dependencies are not installed. Please install with "
-            "`pip install agent-cli[rag]` or `uv sync --extra rag`.",
-        )
-        raise typer.Exit(1) from exc
+    from agent_cli.rag.api import create_app  # noqa: PLC0415
 
     docs_folder = docs_folder.resolve()
     chroma_path = chroma_path.resolve()

agent_cli/agents/speak.py

@@ -14,6 +14,7 @@ from agent_cli import config, opts
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     enable_json_mode,
     get_clipboard_text,
@@ -79,7 +80,8 @@ async def _async_main(
     return text
 
 
-@app.command("speak")
+@app.command("speak", rich_help_panel="Text Commands")
+@requires_extras("audio")
 def speak(
     *,
     text: str | None = typer.Argument(

agent_cli/agents/transcribe.py

@@ -12,13 +12,13 @@ from datetime import UTC, datetime, timedelta
 from pathlib import Path  # noqa: TC003
 from typing import Any, TypedDict
 
-import pyperclip
 import typer
 
 from agent_cli import config, opts
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     enable_json_mode,
     format_short_timedelta,
@@ -363,6 +363,8 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
                 )
             clipboard_snapshot: str | None = None
             if general_cfg.clipboard:
+                import pyperclip  # noqa: PLC0415
+
                 clipboard_snapshot = pyperclip.paste()
                 pyperclip.copy(transcript)
                 LOGGER.info("Copied raw transcript to clipboard before LLM processing.")
@@ -444,6 +446,8 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
             )
 
         if general_cfg.clipboard:
+            import pyperclip  # noqa: PLC0415
+
             pyperclip.copy(transcript)
             LOGGER.info("Copied transcript to clipboard.")
         else:
@@ -460,7 +464,8 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
     )
 
 
-@app.command("transcribe")
+@app.command("transcribe", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def transcribe(  # noqa: PLR0912
     *,
     extra_instructions: str | None = typer.Option(

agent_cli/agents/transcribe_daemon.py

@@ -25,6 +25,7 @@ from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import open_audio_stream, setup_devices, setup_input_stream
 from agent_cli.core.audio_format import check_ffmpeg_available, save_audio_as_mp3
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     console,
     print_command_line_args,
@@ -286,7 +287,8 @@ async def _daemon_loop(cfg: DaemonConfig) -> None:  # noqa: PLR0912, PLR0915
                     await asyncio.wait(background_tasks, timeout=2.0)
 
 
-@app.command("transcribe-daemon")
+@app.command("transcribe-daemon", rich_help_panel="Voice Commands")
+@requires_extras("audio", "vad", "llm")
 def transcribe_daemon(  # noqa: PLR0912
     *,
     # Daemon-specific options

agent_cli/agents/voice_edit.py

@@ -47,6 +47,7 @@ from agent_cli.agents._voice_agent_common import (
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     enable_json_mode,
     get_clipboard_text,
@@ -172,7 +173,8 @@ async def _async_main(
         )
 
 
-@app.command("voice-edit")
+@app.command("voice-edit", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def voice_edit(
     *,
     # --- Provider Selection ---

agent_cli/cli.py

@@ -2,9 +2,12 @@
 
 from __future__ import annotations
 
+import sys
+from pathlib import Path
 from typing import Annotated
 
 import typer
+from rich.table import Table
 
 from . import __version__
 from .config import load_config, normalize_provider_defaults
@@ -14,15 +17,28 @@ from .core.utils import console
 app = typer.Typer(
     name="agent-cli",
     help="A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.",
-    add_completion=True,
     context_settings={"help_option_names": ["-h", "--help"]},
+    add_completion=True,
     rich_markup_mode="markdown",
+    no_args_is_help=True,
 )
 
 
 def _version_callback(value: bool) -> None:
     if value:
-        console.print(f"agent-cli {__version__}")
+        path = Path(__file__).parent
+        data = [
+            ("agent-cli version", __version__),
+            ("agent-cli location", str(path)),
+            ("Python version", sys.version),
+            ("Python executable", sys.executable),
+        ]
+        table = Table(show_header=False)
+        table.add_column("Property", style="cyan")
+        table.add_column("Value", style="magenta")
+        for prop, val in data:
+            table.add_row(prop, val)
+        console.print(table)
         raise typer.Exit
 
 
@@ -86,5 +102,5 @@ from .agents import (  # noqa: E402, F401
     voice_edit,
 )
 from .dev import cli as dev_cli  # noqa: E402, F401
-from .install import hotkeys, services  # noqa: E402, F401
+from .install import extras, hotkeys, services  # noqa: E402, F401
 from .server import cli as server_cli  # noqa: E402, F401

agent_cli/config_cmd.py

@@ -21,6 +21,7 @@ from agent_cli.core.utils import console
 config_app = typer.Typer(
     name="config",
     help="Manage agent-cli configuration files.",
+    add_completion=True,
     rich_markup_mode="markdown",
     no_args_is_help=True,
 )

agent_cli/core/chroma.py

@@ -4,10 +4,6 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
 
-import chromadb
-from chromadb.config import Settings
-from chromadb.utils import embedding_functions
-
 from agent_cli.constants import DEFAULT_OPENAI_EMBEDDING_MODEL
 
 if TYPE_CHECKING:
@@ -28,6 +24,10 @@ def init_collection(
     subdir: str | None = None,
 ) -> Collection:
     """Initialize a Chroma collection with OpenAI-compatible embeddings."""
+    import chromadb  # noqa: PLC0415
+    from chromadb.config import Settings  # noqa: PLC0415
+    from chromadb.utils import embedding_functions  # noqa: PLC0415
+
     target_path = persistence_path / subdir if subdir else persistence_path
     target_path.mkdir(parents=True, exist_ok=True)
     client = chromadb.PersistentClient(