llamactl 0.3.16__py3-none-any.whl → 0.3.17__py3-none-any.whl

llama_deploy/cli/__init__.py

@@ -4,6 +4,7 @@ from llama_deploy.cli.commands.auth import auth
 from llama_deploy.cli.commands.deployment import deployments
 from llama_deploy.cli.commands.env import env_group
 from llama_deploy.cli.commands.init import init
+from llama_deploy.cli.commands.pkg import pkg
 from llama_deploy.cli.commands.serve import serve
 
 from .app import app
@@ -22,7 +23,7 @@ def main() -> None:
     app()
 
 
-__all__ = ["app", "deployments", "auth", "serve", "init", "env_group"]
+__all__ = ["app", "deployments", "auth", "serve", "init", "env_group", "pkg"]
 
 
 if __name__ == "__main__":

llama_deploy/cli/commands/pkg.py

@@ -0,0 +1,122 @@
+from pathlib import Path
+
+import click
+from llama_deploy.cli.pkg import (
+    DEFAULT_DOCKER_IGNORE,
+    build_dockerfile_content,
+    infer_python_version,
+    pkg_container_options,
+)
+from llama_deploy.core.deployment_config import (
+    read_deployment_config_from_git_root_or_cwd,
+)
+from rich import print as rprint
+
+from ..app import app
+
+SUPPORTED_FORMATS = ["Docker", "Podman"]
+SUPPORTED_FORMATS_STR = ", ".join(SUPPORTED_FORMATS)
+
+
+@app.group(
+    help=f"Package your application in different formats. Currently supported: {SUPPORTED_FORMATS_STR}",
+    no_args_is_help=True,
+    context_settings={"max_content_width": None},
+)
+def pkg() -> None:
+    """Package application in different formats (Dockerfile, Podman config, Nixpack...)"""
+    pass
+
+
+@pkg.command(
+    "container",
+    help="Generate a minimal, build-ready file to containerize your workflows through Docker or Podman (currently frontend is not supported).",
+)
+@pkg_container_options
+def create_container_file(
+    deployment_file: Path,
+    python_version: str | None = None,
+    port: int = 4501,
+    exclude: tuple[str, ...] | None = None,
+    output_file: str = "Dockerfile",
+    dockerignore_path: str = ".dockerignore",
+    overwrite: bool = False,
+):
+    _create_file_for_container(
+        deployment_file=deployment_file,
+        python_version=python_version,
+        port=port,
+        exclude=exclude,
+        output_file=output_file,
+        dockerignore_path=dockerignore_path,
+        overwrite=overwrite,
+    )
+
+
+def _check_deployment_config(deployment_file: Path) -> Path:
+    if not deployment_file.exists():
+        rprint(f"[red]Deployment file '{deployment_file}' not found[/red]")
+        raise click.Abort()
+
+    # Early check: appserver requires a pyproject.toml in the config directory
+    config_dir = deployment_file if deployment_file.is_dir() else deployment_file.parent
+    if not (config_dir / "pyproject.toml").exists():
+        rprint(
+            "[red]No pyproject.toml found at[/red] "
+            f"[bold]{config_dir}[/bold].\n"
+            "Add a pyproject.toml to your project and re-run 'llamactl serve'."
+        )
+        raise click.Abort()
+
+    try:
+        config = read_deployment_config_from_git_root_or_cwd(
+            Path.cwd(), deployment_file
+        )
+    except Exception:
+        rprint(
+            "[red]Error: Could not read a deployment config. This doesn't appear to be a valid llama-deploy project.[/red]"
+        )
+        raise click.Abort()
+    if config.ui:
+        rprint(
+            "[bold red]Containerized UI builds are currently not supported. Please remove the UI configuration from your deployment file if you wish to proceed.[/]"
+        )
+        raise click.Abort()
+    return config_dir
+
+
+def _create_file_for_container(
+    deployment_file: Path,
+    output_file: str = "Dockerfile",
+    python_version: str | None = None,
+    port: int = 4501,
+    exclude: tuple[str, ...] | None = None,
+    dockerignore_path: str = ".dockerignore",
+    overwrite: bool = False,
+):
+    config_dir = _check_deployment_config(deployment_file=deployment_file)
+
+    if not python_version:
+        python_version = infer_python_version(config_dir)
+
+    dockerignore_content = DEFAULT_DOCKER_IGNORE
+    if exclude:
+        for item in exclude:
+            dockerignore_content += "\n" + item
+
+    dockerfile_content = build_dockerfile_content(python_version, port)
+
+    if Path(output_file).exists() and not overwrite:
+        rprint(
+            f"[red bold]Error: {output_file} already exists. If you wish to overwrite the file, pass `--overwrite` as a flag to the command.[/]"
+        )
+        raise click.Abort()
+    with open(output_file, "w") as f:
+        f.write(dockerfile_content)
+    if Path(dockerignore_path).exists() and not overwrite:
+        rprint(
+            f"[red bold]Error: {dockerignore_path} already exists. If you wish to overwrite the file, pass `--overwrite` as a flag to the command.[/]"
+        )
+        raise click.Abort()
+    with open(dockerignore_path, "w") as f:
+        f.write(dockerignore_content)

llama_deploy/cli/pkg/__init__.py

@@ -0,0 +1,10 @@
+from .defaults import DEFAULT_DOCKER_IGNORE
+from .options import pkg_container_options
+from .utils import build_dockerfile_content, infer_python_version
+
+__all__ = [
+    "infer_python_version",
+    "build_dockerfile_content",
+    "DEFAULT_DOCKER_IGNORE",
+    "pkg_container_options",
+]

llama_deploy/cli/pkg/defaults.py

@@ -0,0 +1,11 @@
+DEFAULT_DOCKER_IGNORE = """
+.venv/
+.git/
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.env
+"""

llama_deploy/cli/pkg/options.py

@@ -0,0 +1,84 @@
+from pathlib import Path
+from typing import Callable, ParamSpec, TypeVar
+
+import click
+from llama_deploy.core.config import DEFAULT_DEPLOYMENT_FILE_PATH
+
+P = ParamSpec("P")
+R = TypeVar("R")
+
+
+def _deployment_file_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.argument(
+        "deployment_file",
+        required=False,
+        default=DEFAULT_DEPLOYMENT_FILE_PATH,
+        type=click.Path(dir_okay=True, resolve_path=True, path_type=Path),
+    )(f)
+
+
+def _python_version_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.option(
+        "--python-version",
+        help="Python version for the base image. Default is inferred from the uv project configuration (.python-version or pyproject.toml). If no version can be inferred, python 3.12 is used.",
+        required=False,
+        default=None,
+    )(f)
+
+
+def _port_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.option(
+        "--port",
+        help="The port to run the API server on. Defaults to 4501.",
+        required=False,
+        default=4501,
+        type=int,
+    )(f)
+
+
+def _dockerignore_path_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.option(
+        "--dockerignore-path",
+        help="Path for the output .dockerignore file. Defaults to .dockerignore",
+        required=False,
+        default=".dockerignore",
+    )(f)
+
+
+def _output_file_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.option(
+        "--output-file",
+        help="Path for the output file to build the image. Defaults to Dockerfile",
+        required=False,
+        default="Dockerfile",
+    )(f)
+
+
+def _overwrite_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.option(
+        "--overwrite",
+        help="Overwrite output files",
+        is_flag=True,
+    )(f)
+
+
+def _exclude_option(f: Callable[P, R]) -> Callable[P, R]:
+    return click.option(
+        "--exclude",
+        help="Path to exclude from the build (will be appended to .dockerignore). Can be used multiple times.",
+        multiple=True,
+        required=False,
+        default=None,
+    )(f)
+
+
+def pkg_container_options(f: Callable[P, R]) -> Callable[P, R]:
+    return _deployment_file_option(
+        _python_version_option(
+            _port_option(
+                _dockerignore_path_option(
+                    _overwrite_option(_exclude_option(_output_file_option(f)))
+                )
+            )
+        )
+    )

llama_deploy/cli/pkg/utils.py

@@ -0,0 +1,46 @@
+from pathlib import Path
+from tomllib import load as load_toml
+
+
+def _get_min_py_version(requires_python: str):
+    min_v = requires_python.split(",")[0].strip()
+    return (
+        min_v.replace("=", "")
+        .replace(">", "")
+        .replace("<", "")
+        .replace("~", "")
+        .strip()
+    )
+
+
+def infer_python_version(config_dir: Path):
+    if (config_dir / ".python-version").exists():
+        with open(config_dir / ".python-version", "r") as f:
+            content = f.read()
+            if content.strip():
+                py_version = content.strip()
+                return py_version
+    with open(config_dir / "pyproject.toml", "rb") as f:
+        data = load_toml(f)
+    return _get_min_py_version(data.get("project", {}).get("requires-python", "3.12"))
+
+
+def build_dockerfile_content(python_version: str | None = None, port: int = 4501):
+    return f"""
+FROM python:{python_version}-slim-trixie
+
+COPY --from=ghcr.io/astral-sh/uv:latest /uv /uvx /bin/
+
+WORKDIR /app
+
+COPY . /app/
+
+ENV PATH=/root/.local/bin:$PATH
+
+RUN uv sync --locked
+RUN uv tool install llamactl
+
+EXPOSE {port}
+
+ENTRYPOINT [ "uv", "run", "llamactl", "serve", "--host", "0.0.0.0", "--port", "{port}" ]
+"""

{llamactl-0.3.16.dist-info → llamactl-0.3.17.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: llamactl
-Version: 0.3.16
+Version: 0.3.17
 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[client]>=0.3.16,<0.4.0
-Requires-Dist: llama-deploy-appserver>=0.3.16,<0.4.0
+Requires-Dist: llama-deploy-core[client]>=0.3.17,<0.4.0
+Requires-Dist: llama-deploy-appserver>=0.3.17,<0.4.0
 Requires-Dist: vibe-llama-core>=0.1.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: questionary>=2.0.0

{llamactl-0.3.16.dist-info → llamactl-0.3.17.dist-info}/RECORD

@@ -1,4 +1,4 @@
-llama_deploy/cli/__init__.py,sha256=116170a773d7377f2e61bc8b006999d463af24027867be54ff9b20132970490f,781
+llama_deploy/cli/__init__.py,sha256=ae22d4cdf686aeef367d80d71938c62d7570d9bddd454c44fa78b3354f25d4f5,834
 llama_deploy/cli/app.py,sha256=9170e4f506c482522bd745eb1cdb700a198cfcfd7204c168c94e5ee2b6b43ffa,2199
 llama_deploy/cli/auth/client.py,sha256=3ebd2526f65f8d576e17d304df1b8a163d07586b88b5628cb36c9fa487a23ef6,11841
 llama_deploy/cli/client.py,sha256=f4053b5183224cff55c1393e78887d1af2597219135379a851b742c676adc154,1727
@@ -7,6 +7,7 @@ llama_deploy/cli/commands/auth.py,sha256=1381eee494c3a0c73253322b4a54af1a857d5b8
 llama_deploy/cli/commands/deployment.py,sha256=abea89e94ed978821a998453792d127605831ba23108df776873852ddd19f97e,14526
 llama_deploy/cli/commands/env.py,sha256=36cb1b0abb9e3d1c5546d3e8a3c4c7839c4d6c2abf75763e39efb08376b3eae9,6808
 llama_deploy/cli/commands/init.py,sha256=348ec90fb54a6774062b109afe8cc9ac7f3c59144f941fd5697001ea52d5b946,14981
+llama_deploy/cli/commands/pkg.py,sha256=31049a8266fba71a45920187ef983988bb5ba3b9ad81ab4b7bca6042a071a810,4068
 llama_deploy/cli/commands/serve.py,sha256=e1e91f17e13dce31ebadb4a1b91cda9e2e3eeb45f89f1db0ae3fadd879e8a2ab,12871
 llama_deploy/cli/config/_config.py,sha256=654a4b6d06542e3503edab7023fc1c3148de510b3e3f6194e28cd4bd3e7c029a,14230
 llama_deploy/cli/config/_migrations.py,sha256=37055641970e1ea41abc583f270dc8a9dab03076224a02cd5fb08bbab2b9259f,2333
@@ -21,6 +22,10 @@ llama_deploy/cli/env.py,sha256=d4b83c1f12e07f90893fcc7388d769de37dc2b41d345eb6bc
 llama_deploy/cli/interactive_prompts/session_utils.py,sha256=b996f2eddf70d6c49636c4797d246d212fce0950fe7e9a3f59cf6a1bf7ae26f5,1142
 llama_deploy/cli/interactive_prompts/utils.py,sha256=594cc2a242cc3405d66d0e26a60647496cc5fcb4ce7d0500a4cfec4888c9a0fa,516
 llama_deploy/cli/options.py,sha256=1bddcaf69c0293b07ce8b73fa4ef92d62ea5d8eecd7f66b65e957d4a59381243,2479
+llama_deploy/cli/pkg/__init__.py,sha256=6e5ba5891b4d71c046fd4759202c1326ea686aeaaa54e2cbf4e78c86a80d6286,286
+llama_deploy/cli/pkg/defaults.py,sha256=3d315935352f5271e301fc907420f44e616630911e6e6fb6a33bf9f57adb57c3,104
+llama_deploy/cli/pkg/options.py,sha256=540c619a2a11f72161b8e41002446cf9d3f62de605d6026d262d5e72cb36bd82,2418
+llama_deploy/cli/pkg/utils.py,sha256=b25348ac0f9ddc984ef98edc930aef0648ed182437e660cc60b0daf56172b171,1197
 llama_deploy/cli/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
 llama_deploy/cli/styles.py,sha256=15901fb567b0d10470f56a06d863819c4ed00a9f90b2a8c46b4bc2fb1dbdf6c3,307
 llama_deploy/cli/textual/deployment_form.py,sha256=92602faca36ba453e7b2c4ab04644e4bf4c12f98ff60d619ebd2697b06a70692,28953
@@ -34,7 +39,7 @@ llama_deploy/cli/textual/styles.tcss,sha256=2536f52ea1a654ae1f8990a25d45c845cb31
 llama_deploy/cli/utils/env_inject.py,sha256=01911758bcc3cf22aad0db0d1ade56aece48d6ad6bdb7186ea213337c67f5a89,688
 llama_deploy/cli/utils/redact.py,sha256=1e768d76b4a6708230c34f7ce8a5a82ab52795bb3d6ab0387071ab4e8d7e7934,863
 llama_deploy/cli/utils/version.py,sha256=bf01a6dda948b868cc08c93701ed44cd36b487402404af8451d4c0996a2edb31,364
-llamactl-0.3.16.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
-llamactl-0.3.16.dist-info/entry_points.txt,sha256=b67e1eb64305058751a651a80f2d2268b5f7046732268421e796f64d4697f83c,52
-llamactl-0.3.16.dist-info/METADATA,sha256=d0fc19ba6e842db8013553c960a0ec24c47f7d4812ef570a5686806b249f4b49,3217
-llamactl-0.3.16.dist-info/RECORD,,
+llamactl-0.3.17.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
+llamactl-0.3.17.dist-info/entry_points.txt,sha256=b67e1eb64305058751a651a80f2d2268b5f7046732268421e796f64d4697f83c,52
+llamactl-0.3.17.dist-info/METADATA,sha256=53b3447ce6786b1e6e5258271157338fb6f3c39c9ba2cb1529b9427a2fe85f34,3217
+llamactl-0.3.17.dist-info/RECORD,,