pkg

Caution

This command is currently limited to python agent workflows. Frontend packaging is not yet supported.

The pkg command group lets you package and export your application for custom deployments. Currently it supports exporting a Dockerfile that can be built into an image with any OCI compliant image builder, such as docker or podman.

Usage

llamactl pkg [COMMAND] [options]

Available Commands

• container – Generate a minimal, build-ready container file (e.g., Dockerfile) for your workflows.

Command: container

llamactl pkg container [DEPLOYMENT_FILE] [options]

Generates a container build file from a given deployment file and user-specified options.

Options

• deployment_file - Path to the deployment file. Defaults to the current directory (.)
• --python-version - Python version for the base image. If not specified, it’s inferred from .python-version or pyproject.toml; defaults to 3.12 if none found.
• --port <int> - Port to expose for the API server. Defaults to 4501.
• --dockerignore-path - Path for the generated .dockerignore file. Defaults to .dockerignore.
• --overwrite - Overwrite any existing output files. No default value.
• --exclude <path> - Path(s) to exclude from the build (appended to .dockerignore). Can be used multiple times. No default value.
• --output-file - Path and filename for the generated container build file. Defaults to Dockerfile.
• --help - Show help for this command and exit. No default value.

Notes

• The generated .dockerignore file automatically excludes common Python-related directories such as:
  • Local virtual environments
  • Caches
  • Files that may contain sensitive data (e.g., .env)
• The produced container file is minimal by design. It should work for most cases, but you may need to customize it for specific use cases.

Examples

1. Create default Dockerfile and .dockerignore:

llamactl pkg container

2. Generate a custom container file with specific name, Python version, and port:

llamactl pkg container --output-file Containerfile --python-version 3.14 --port 4502

3. Exclude certain files or directories from the build:

llamactl pkg container --exclude .env.local --exclude .github/workflows/ --exclude "*.pdf"