llamactl 0.2.7a1__tar.gz → 0.3.0a2__tar.gz

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: llamactl
-Version: 0.2.7a1
+Version: 0.3.0a2
 Summary: A command-line interface for managing LlamaDeploy projects and deployments
 Author: Adrian Lyjak
 Author-email: Adrian Lyjak <adrianlyjak@gmail.com>
 License: MIT
-Requires-Dist: llama-deploy-core>=0.2.7a1,<0.3.0
-Requires-Dist: llama-deploy-appserver>=0.2.7a1,<0.3.0
+Requires-Dist: llama-deploy-core>=0.3.0a2,<0.4.0
+Requires-Dist: llama-deploy-appserver>=0.3.0a2,<0.4.0
 Requires-Dist: httpx>=0.24.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: questionary>=2.0.0
@@ -15,6 +15,7 @@ Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: tenacity>=9.1.2
 Requires-Dist: textual>=4.0.0
 Requires-Dist: aiohttp>=3.12.14
+Requires-Dist: copier>=9.9.0
 Requires-Python: >=3.12, <4
 Description-Content-Type: text/markdown
 

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "llamactl"
-version = "0.2.7a1"
+version = "0.3.0a2"
 description = "A command-line interface for managing LlamaDeploy projects and deployments"
 readme = "README.md"
 license = { text = "MIT" }
@@ -9,8 +9,8 @@ authors = [
 ]
 requires-python = ">=3.12, <4"
 dependencies = [
-    "llama-deploy-core>=0.2.7a1,<0.3.0",
-    "llama-deploy-appserver>=0.2.7a1,<0.3.0",
+    "llama-deploy-core>=0.3.0a2,<0.4.0",
+    "llama-deploy-appserver>=0.3.0a2,<0.4.0",
     "httpx>=0.24.0",
     "rich>=13.0.0",
     "questionary>=2.0.0",
@@ -19,6 +19,7 @@ dependencies = [
     "tenacity>=9.1.2",
     "textual>=4.0.0",
     "aiohttp>=3.12.14",
+    "copier>=9.9.0",
 ]
 
 [project.scripts]

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/src/llama_deploy/cli/__init__.py

@@ -1,5 +1,5 @@
 import click
-from .commands import projects, deployments, profile, health_check, serve
+from .commands import projects, deployments, profile, health_check, serve, version
 from .options import global_options
 
 
@@ -22,6 +22,9 @@ app.add_command(health_check, name="health")
 # Add serve command at root level
 app.add_command(serve, name="serve")
 
+# Add version command at root level
+app.add_command(version, name="version")
+
 
 # Main entry point function (called by the script)
 def main() -> None:

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/src/llama_deploy/cli/client.py

@@ -1,4 +1,3 @@
-import logging
 from typing import List, Optional
 
 import httpx
@@ -18,109 +17,102 @@ from rich.console import Console
 from .config import config_manager
 
 
-class LlamaDeployClient:
-    """HTTP client for communicating with the LlamaDeploy control plane API"""
-
-    def __init__(
-        self, base_url: Optional[str] = None, project_id: Optional[str] = None
-    ):
-        """Initialize the client with a configured profile"""
-        self.console = Console()
-
-        # Get profile data
-        profile = config_manager.get_current_profile()
-        if not profile:
-            self.console.print("\n[bold red]No profile configured![/bold red]")
-            self.console.print("\nTo get started, create a profile with:")
-            self.console.print("[cyan]llamactl profile create[/cyan]")
-            raise SystemExit(1)
-
-        # Use profile data with optional overrides
-        self.base_url = base_url or profile.api_url
-        self.project_id = project_id or profile.active_project_id
-
-        if not self.base_url:
-            raise ValueError("API URL is required")
-
-        if not self.project_id:
-            raise ValueError("Project ID is required")
-
-        self.base_url = self.base_url.rstrip("/")
-
-        # Create persistent client with event hooks
+class BaseClient:
+    def __init__(self, base_url: str, console: Console) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.console = console
         self.client = httpx.Client(
             base_url=self.base_url, event_hooks={"response": [self._handle_response]}
         )
 
     def _handle_response(self, response: httpx.Response) -> None:
-        """Handle response middleware - warnings and error conversion"""
-        # Check for warnings in response headers
         if "X-Warning" in response.headers:
             self.console.print(
                 f"[yellow]Warning: {response.headers['X-Warning']}[/yellow]"
             )
-
-        # Convert httpx errors to our current exception format
         try:
             response.raise_for_status()
         except httpx.HTTPStatusError as e:
-            # Try to parse JSON error response
             try:
-                response.read()  # need to collect streaming data before calling json
+                response.read()
                 error_data = e.response.json()
                 if isinstance(error_data, dict) and "detail" in error_data:
                     error_message = error_data["detail"]
                 else:
                     error_message = str(error_data)
             except (ValueError, KeyError):
-                # Fallback to raw response text
                 error_message = e.response.text
-
             raise Exception(f"HTTP {e.response.status_code}: {error_message}") from e
         except httpx.RequestError as e:
             raise Exception(f"Request failed: {e}") from e
 
-    # Health check
+
+class ControlPlaneClient(BaseClient):
+    """Unscoped client for non-project endpoints."""
+
     def health_check(self) -> dict:
-        """Check if the API server is healthy"""
         response = self.client.get("/health")
         return response.json()
 
-    # Projects
+    def server_version(self) -> dict:
+        response = self.client.get("/version")
+        return response.json()
+
     def list_projects(self) -> List[ProjectSummary]:
-        """List all projects with deployment counts"""
         response = self.client.get("/projects/")
         projects_response = ProjectsListResponse.model_validate(response.json())
         return [project for project in projects_response.projects]
 
-    # Deployments
+
+class ProjectClient(BaseClient):
+    """Project-scoped client for deployment operations."""
+
+    def __init__(
+        self,
+        base_url: Optional[str] = None,
+        project_id: Optional[str] = None,
+        console: Optional[Console] = None,
+    ) -> None:
+        # Allow default construction using active profile (for tests and convenience)
+        if base_url is None or project_id is None:
+            profile = config_manager.get_current_profile()
+            if not profile:
+                # Match previous behavior for missing profiles
+                (console or Console()).print(
+                    "\n[bold red]No profile configured![/bold red]"
+                )
+                (console or Console()).print("\nTo get started, create a profile with:")
+                (console or Console()).print("[cyan]llamactl profile create[/cyan]")
+                raise SystemExit(1)
+            base_url = base_url or profile.api_url or ""
+            project_id = project_id or profile.active_project_id
+        if not base_url:
+            raise ValueError("API URL is required")
+        if not project_id:
+            raise ValueError("Project ID is required")
+        resolved_console = console or Console()
+        super().__init__(base_url, resolved_console)
+        self.project_id = project_id
+
     def list_deployments(self) -> List[DeploymentResponse]:
-        """List deployments for the configured project"""
         response = self.client.get(f"/{self.project_id}/deployments/")
         deployments_response = DeploymentsListResponse.model_validate(response.json())
         return [deployment for deployment in deployments_response.deployments]
 
     def get_deployment(self, deployment_id: str) -> DeploymentResponse:
-        """Get a specific deployment"""
         response = self.client.get(f"/{self.project_id}/deployments/{deployment_id}")
-        deployment = DeploymentResponse.model_validate(response.json())
-        return deployment
+        return DeploymentResponse.model_validate(response.json())
 
     def create_deployment(
-        self,
-        deployment_data: DeploymentCreate,
+        self, deployment_data: DeploymentCreate
     ) -> DeploymentResponse:
-        """Create a new deployment"""
-
         response = self.client.post(
             f"/{self.project_id}/deployments/",
             json=deployment_data.model_dump(exclude_none=True),
         )
-        deployment = DeploymentResponse.model_validate(response.json())
-        return deployment
+        return DeploymentResponse.model_validate(response.json())
 
     def delete_deployment(self, deployment_id: str) -> None:
-        """Delete a deployment"""
         self.client.delete(f"/{self.project_id}/deployments/{deployment_id}")
 
     def update_deployment(
@@ -129,19 +121,15 @@ class LlamaDeployClient:
         update_data: DeploymentUpdate,
         force_git_sha_update: bool = False,
     ) -> DeploymentResponse:
-        """Update an existing deployment"""
-
         params = {}
         if force_git_sha_update:
             params["force_git_sha_update"] = True
-
         response = self.client.patch(
             f"/{self.project_id}/deployments/{deployment_id}",
             json=update_data.model_dump(),
             params=params,
         )
-        deployment = DeploymentResponse.model_validate(response.json())
-        return deployment
+        return DeploymentResponse.model_validate(response.json())
 
     def validate_repository(
         self,
@@ -149,10 +137,6 @@ class LlamaDeployClient:
         deployment_id: str | None = None,
         pat: str | None = None,
     ) -> RepositoryValidationResponse:
-        """Validate a repository URL"""
-        logging.info(
-            f"Validating repository with params: {repo_url}, {deployment_id}, {pat}"
-        )
         response = self.client.post(
             f"/{self.project_id}/deployments/validate-repository",
             json=RepositoryValidationRequest(
@@ -161,13 +145,37 @@ class LlamaDeployClient:
                 pat=pat,
             ).model_dump(),
         )
-        logging.info(f"Response: {response.json()}")
         return RepositoryValidationResponse.model_validate(response.json())
 
 
-# Global client factory function
-def get_client(
+def get_control_plane_client(base_url: Optional[str] = None) -> ControlPlaneClient:
+    console = Console()
+    profile = config_manager.get_current_profile()
+    if not profile and not base_url:
+        console.print("\n[bold red]No profile configured![/bold red]")
+        console.print("\nTo get started, create a profile with:")
+        console.print("[cyan]llamactl profile create[/cyan]")
+        raise SystemExit(1)
+    resolved_base_url = (base_url or (profile.api_url if profile else "")).rstrip("/")
+    if not resolved_base_url:
+        raise ValueError("API URL is required")
+    return ControlPlaneClient(resolved_base_url, console)
+
+
+def get_project_client(
     base_url: Optional[str] = None, project_id: Optional[str] = None
-) -> LlamaDeployClient:
-    """Get a client instance with optional overrides"""
-    return LlamaDeployClient(base_url=base_url, project_id=project_id)
+) -> ProjectClient:
+    console = Console()
+    profile = config_manager.get_current_profile()
+    if not profile:
+        console.print("\n[bold red]No profile configured![/bold red]")
+        console.print("\nTo get started, create a profile with:")
+        console.print("[cyan]llamactl profile create[/cyan]")
+        raise SystemExit(1)
+    resolved_base_url = (base_url or profile.api_url or "").rstrip("/")
+    if not resolved_base_url:
+        raise ValueError("API URL is required")
+    resolved_project_id = project_id or profile.active_project_id
+    if not resolved_project_id:
+        raise ValueError("Project ID is required")
+    return ProjectClient(resolved_base_url, resolved_project_id, console)

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/src/llama_deploy/cli/commands.py

@@ -1,18 +1,15 @@
-import os
-import subprocess
 from pathlib import Path
 from typing import Optional
 
 import click
-from llama_deploy.appserver.client import Client as ApiserverClient
+from llama_deploy.appserver.app import start_server
 from llama_deploy.core.config import DEFAULT_DEPLOYMENT_FILE_PATH
 from llama_deploy.core.schema.deployments import DeploymentUpdate
 from rich import print as rprint
 from rich.console import Console
 from rich.table import Table
-from tenacity import RetryError, Retrying, stop_after_attempt, wait_fixed
 
-from .client import get_client
+from .client import get_project_client, get_control_plane_client
 from .config import config_manager
 from .interactive_prompts.utils import (
     confirm_action,
@@ -220,7 +217,7 @@ def edit_profile(name: Optional[str]) -> None:
 def list_projects() -> None:
     """List all projects with deployment counts"""
     try:
-        client = get_client()
+        client = get_control_plane_client()
         projects = client.list_projects()
 
         if not projects:
@@ -249,7 +246,7 @@ def list_projects() -> None:
 def health_check() -> None:
     """Check if the API server is healthy"""
     try:
-        client = get_client()
+        client = get_control_plane_client()
         health = client.health_check()
 
         status = health.get("status", "unknown")
@@ -269,7 +266,7 @@ def health_check() -> None:
 def list_deployments() -> None:
     """List deployments for the configured project"""
     try:
-        client = get_client()
+        client = get_project_client()
         deployments = client.list_deployments()
 
         if not deployments:
@@ -323,7 +320,7 @@ def list_deployments() -> None:
 def get_deployment(deployment_id: Optional[str]) -> None:
     """Get details of a specific deployment"""
     try:
-        client = get_client()
+        client = get_project_client()
 
         deployment_id = select_deployment(deployment_id)
         if not deployment_id:
@@ -395,7 +392,7 @@ def create_deployment(
 def delete_deployment(deployment_id: Optional[str], confirm: bool) -> None:
     """Delete a deployment"""
     try:
-        client = get_client()
+        client = get_project_client()
 
         deployment_id = select_deployment(deployment_id)
         if not deployment_id:
@@ -421,7 +418,7 @@ def delete_deployment(deployment_id: Optional[str], confirm: bool) -> None:
 def edit_deployment(deployment_id: Optional[str]) -> None:
     """Interactively edit a deployment"""
     try:
-        client = get_client()
+        client = get_project_client()
 
         deployment_id = select_deployment(deployment_id)
         if not deployment_id:
@@ -452,7 +449,7 @@ def edit_deployment(deployment_id: Optional[str]) -> None:
 def refresh_deployment(deployment_id: Optional[str]) -> None:
     """Refresh a deployment with the latest code from its git reference"""
     try:
-        client = get_client()
+        client = get_project_client()
 
         deployment_id = select_deployment(deployment_id)
         if not deployment_id:
@@ -493,53 +490,41 @@ def refresh_deployment(deployment_id: Optional[str]) -> None:
     default=DEFAULT_DEPLOYMENT_FILE_PATH,
     type=click.Path(dir_okay=False, resolve_path=True, path_type=Path),  # type: ignore
 )
+@click.option(
+    "--no-install", is_flag=True, help="Skip installing python and js dependencies"
+)
+@click.option(
+    "--no-reload", is_flag=True, help="Skip reloading the API server on code changes"
+)
+@click.option("--no-open-browser", is_flag=True, help="Skip opening the browser")
+@click.option(
+    "--preview",
+    is_flag=True,
+    help="Preview mode pre-builds the UI to static files, like a production build",
+)
 @global_options
-def serve(deployment_file: Path) -> None:
+def serve(
+    deployment_file: Path,
+    no_install: bool,
+    no_reload: bool,
+    no_open_browser: bool,
+    preview: bool,
+) -> None:
     """Run llama_deploy API Server in the foreground. If no deployment_file is provided, will look for a llama_deploy.yaml in the current directory."""
     if not deployment_file.exists():
         rprint(f"[red]Deployment file '{deployment_file}' not found[/red]")
         raise click.Abort()
 
     try:
-        env = os.environ.copy()
-        env["LLAMA_DEPLOY_APISERVER_DEPLOYMENTS_PATH"] = str(deployment_file.parent)
-
-        client = ApiserverClient()
-
-        uvicorn_p = subprocess.Popen(
-            [
-                "uvicorn",
-                "llama_deploy.appserver.app:app",
-                "--host",
-                "localhost",
-                "--port",
-                "4501",
-            ],
-            env=env,
-        )
-
-        retrying = Retrying(
-            stop=stop_after_attempt(5), wait=wait_fixed(RETRY_WAIT_SECONDS)
+        start_server(
+            cwd=deployment_file.parent,
+            deployment_file=deployment_file,
+            proxy_ui=not preview,
+            reload=not no_reload,
+            install=not no_install,
+            build=preview,
+            open_browser=not no_open_browser,
         )
-        try:
-            for attempt in retrying:
-                with attempt:
-                    client.sync.apiserver.deployments.create(
-                        deployment_file.open("rb"),
-                        base_path=deployment_file.parent,
-                        local=True,
-                    )
-        except RetryError as e:
-            uvicorn_p.terminate()
-            last: Optional[BaseException] = e.last_attempt.exception(0)
-            last_msg = ""
-            if last is not None:
-                last_msg = ": " + (
-                    str(last.message) if hasattr(last, "message") else str(last)
-                )
-            raise click.ClickException(f"Failed to create deployment{last_msg}")
-
-        uvicorn_p.wait()
 
     except KeyboardInterrupt:
         print("Shutting down...")
@@ -547,3 +532,31 @@ def serve(deployment_file: Path) -> None:
     except Exception as e:
         rprint(f"[red]Error: {e}[/red]")
         raise click.Abort()
+
+
+@click.command("version")
+@global_options
+def version() -> None:
+    """Print the version of llama_deploy"""
+    try:
+        from importlib.metadata import PackageNotFoundError, version as pkg_version
+
+        ver = pkg_version("llamactl")
+        rprint(f"client version: {ver}")
+
+        # If there is an active profile, attempt to query server version
+        profile = config_manager.get_current_profile()
+        if profile and profile.api_url:
+            try:
+                cp_client = get_control_plane_client()
+                data = cp_client.server_version()
+                server_ver = data.get("version", "unknown")
+                rprint(f"server version: {server_ver}")
+            except Exception as e:
+                rprint(f"server version: [yellow]unavailable[/yellow] ({e})")
+    except PackageNotFoundError:
+        rprint("[red]Package 'llamactl' not found[/red]")
+        raise click.Abort()
+    except Exception as e:
+        rprint(f"[red]Error: {e}[/red]")
+        raise click.Abort()

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/src/llama_deploy/cli/interactive_prompts/utils.py

@@ -6,7 +6,7 @@ import questionary
 from rich import print as rprint
 from rich.console import Console
 
-from ..client import get_client
+from ..client import get_project_client as get_client
 from ..config import config_manager
 
 console = Console()

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/src/llama_deploy/cli/textual/deployment_form.py

@@ -21,7 +21,7 @@ from textual.containers import Container, HorizontalGroup, Widget
 from textual.validation import Length
 from textual.widgets import Button, Input, Label, Static
 from textual.reactive import reactive
-from llama_deploy.cli.client import get_client
+from llama_deploy.cli.client import get_project_client as get_client
 from textual.message import Message
 
 
@@ -361,7 +361,6 @@ class DeploymentEditApp(App[DeploymentResponse | None]):
     def on_validation_cancel_message(self, message: ValidationCancelMessage) -> None:
         """Handle validation cancellation from git validation widget"""
         # Return to form, clearing any save error
-        print("DEBUG: on_validation_cancel_message")
         self.save_error = ""
         self.current_state = "form"
 

{llamactl-0.2.7a1 → llamactl-0.3.0a2}/src/llama_deploy/cli/textual/git_validation.py

@@ -11,7 +11,7 @@ from textual.message import Message
 from textual.content import Content
 from textual.reactive import reactive
 
-from llama_deploy.cli.client import get_client
+from llama_deploy.cli.client import get_project_client as get_client
 from llama_deploy.core.schema.git_validation import RepositoryValidationResponse
 from llama_deploy.cli.textual.llama_loader import PixelLlamaLoader
 from llama_deploy.cli.textual.github_callback_server import GitHubCallbackServer
@@ -206,7 +206,6 @@ class GitValidationWidget(Widget):
                 yield Button(
                     "Continue", id="continue_success", variant="primary", compact=True
                 )
-            print("DEBUG: render cancel button")
             # Always show cancel button
             yield Button("Back to Edit", id="cancel", variant="default", compact=True)
 
@@ -238,7 +237,6 @@ class GitValidationWidget(Widget):
             )
             self.post_message(ValidationResultMessage(self.repo_url, pat_to_send))
         elif event.button.id == "cancel":
-            print("DEBUG: cancel button pressed")
             self.post_message(ValidationCancelMessage())
 
     def _start_github_auth(self) -> None: