feat: separate out and update typer dependency

Author: jakelorocco

cli/m.py

@@ -6,7 +6,13 @@
 evaluation). Run ``m --help`` to see all available sub-commands.
 """
 
-import typer
+try:
+    import typer
+except ImportError:
+    raise SystemExit(
+        "The 'm' CLI requires extra dependencies. "
+        'Please install them with: pip install "mellea[cli]"'
+    ) from None
 
 from cli.alora.commands import alora_app
 from cli.decompose import app as decompose_app

docs/alora.md

@@ -9,7 +9,7 @@ Mellea provides a command-line interface for training and uploading [LoRA](https
 From the root of the repository:
 
 ```bash
-pip install mellea
+pip install "mellea[cli]"
 huggingface-cli login  # Optional: only needed for uploads
 ```
 

docs/docs/advanced/lora-and-alora-adapters.md

@@ -11,7 +11,7 @@ schemes not well-represented in general training data. Mellea lets you train a
 [aLoRA](https://github.com/IBM/activated-lora) adapter on your own labeled dataset
 and use it as a requirement validator in any Mellea program.
 
-**Prerequisites:** `pip install mellea`, `m` CLI available. Training requires a GPU or
+**Prerequisites:** `pip install "mellea[cli]"`. Training requires a GPU or
 Apple Silicon Mac with sufficient VRAM for the chosen base model. Uploading requires a
 Hugging Face account.
 

docs/docs/getting-started/installation.md

@@ -25,6 +25,7 @@ pip install "mellea[litellm]"    # LiteLLM multi-provider (Anthropic, Bedrock, e
 pip install "mellea[hf]"         # HuggingFace transformers for local inference
 pip install "mellea[watsonx]"    # IBM WatsonX
 pip install "mellea[tools]"      # Tool and agent dependencies (LangChain, smolagents)
+pip install "mellea[cli]"        # m serve, m alora, m decompose CLI commands
 pip install "mellea[telemetry]"  # OpenTelemetry tracing and metrics
 ```
 
@@ -33,6 +34,7 @@ uv add "mellea[litellm]"        # LiteLLM multi-provider (Anthropic, Bedrock, et
 uv add "mellea[hf]"             # HuggingFace transformers for local inference
 uv add "mellea[watsonx]"        # IBM WatsonX
 uv add "mellea[tools]"          # Tool and agent dependencies (LangChain, smolagents)
+uv add "mellea[cli]"            # m serve, m alora, m decompose CLI commands
 uv add "mellea[telemetry]"      # OpenTelemetry tracing and metrics
 ```
 

docs/docs/guide/m-decompose.md

@@ -11,7 +11,7 @@ description: "Break complex tasks into ordered, executable subtasks with the m d
 3. Generate a prompt template for each subtask
 4. Output a ready-to-run Python script that executes each subtask in order
 
-**Prerequisites:** Mellea installed (`uv add mellea`), Ollama running locally (or an OpenAI-compatible endpoint).
+**Prerequisites:** Mellea installed (`uv add "mellea[cli]"`), Ollama running locally (or an OpenAI-compatible endpoint).
 
 ## Basic usage
 

docs/docs/how-to/refactor-prompts-with-cli.md

@@ -5,7 +5,7 @@ description: "Use m decompose to break a complex prompt into typed, validated ge
 # diataxis: how-to
 ---
 
-**Prerequisites:** `pip install mellea`, Ollama running locally (or an
+**Prerequisites:** `pip install "mellea[cli]"`, Ollama running locally (or an
 OpenAI-compatible endpoint).
 
 When a single prompt grows too long or asks the LLM to do too many things at

docs/docs/integrations/m-serve.md

@@ -8,7 +8,7 @@ description: "Run a Mellea program as an OpenAI-compatible chat endpoint with m
 any LLM client — LangChain, the OpenAI SDK, `curl` — call your Mellea program as if
 it were a model.
 
-**Prerequisites:** `pip install mellea`.
+**Prerequisites:** `pip install "mellea[cli]"`.
 
 ## The serve() function
 

pyproject.toml

@@ -23,8 +23,6 @@ dependencies = [
     "jinja2",
     "ollama>=0.5.1",
     "requests>=2.32.3",
-    "typer",
-    "click<8.2.0", # Newer versions will cause errors with --help in typer CLIs.
     "mistletoe>=1.4.0",
     "pillow", # Needed for Intrinsics (HF and OpenAI Backends).
     "math_verify", # Needed for Majority Voting Sampling Strategies.
@@ -91,6 +89,10 @@ granite_retriever = [
     "elasticsearch>=8.0.0,<9.0.0",
 ]
 
+cli = [
+    "typer",
+]
+
 # Infrastructure
 server = [
     "uvicorn",
@@ -108,7 +110,7 @@ hooks = [
     "grpcio>=1.78.0",
 ]
 
-all = ["mellea[backends,docling,tools,telemetry,server,sandbox,granite_retriever,hooks]"]
+all = ["mellea[backends,docling,tools,telemetry,server,sandbox,granite_retriever,hooks,cli]"]
 
 [dependency-groups]
 # Development groups: uv sync --all-groups

test/package/test_dependency_isolation.py

@@ -63,6 +63,7 @@
         "import pyarrow",
         "import elasticsearch",
     ],
+    "cli": ["import typer"],
     "server": ["import uvicorn", "import fastapi"],
     "sandbox": ["import llm_sandbox"],
     "hooks": [
@@ -102,6 +103,7 @@
     "server",
     "sandbox",
     "hooks",
+    "cli",
     "backends",
 }
 
@@ -369,6 +371,11 @@ def test_sandbox() -> None:
     _run_check(extra="sandbox", should_succeed=[*IMPORTS["core"], *IMPORTS["sandbox"]])
 
 
+def test_cli() -> None:
+    """mellea[cli]: typer is available."""
+    _run_check(extra="cli", should_succeed=[*IMPORTS["core"], *IMPORTS["cli"]])
+
+
 def test_hooks() -> None:
     """mellea[hooks]: plugin framework is available."""
     _run_check(