A command-line interface for managing LlamaDeploy projects and deployments
Project description
llamactl
llamactl is the CLI for developing LlamaAgents apps locally and managing their LlamaCloud deployments.
For the full guide, see the LlamaAgents llamactl docs.
Installation
Install globally with uv:
uv tool install -U llamactl
Or pin it to a project:
uv add --dev llamactl
Quick Start
Create or select an auth profile:
llamactl auth login
If browser login is not available, use an API key:
llamactl auth token --api-key "$LLAMA_CLOUD_API_KEY" --project "$LLAMA_AGENTS_PROJECT_ID"
Scaffold and run an app:
llamactl init
cd my-app
llamactl serve
Create a cloud deployment:
llamactl deployments create
Inspect it and stream logs:
llamactl deployments get
llamactl deployments get NAME
llamactl deployments logs NAME --follow
For declarative deployments:
llamactl deployments template > deployment.yaml
llamactl deployments apply -f deployment.yaml
Command Groups
llamactl auth: log in, create API-key profiles, and switch profiles.llamactl environments: list, add, inspect, and switch LlamaCloud API environments.llamactl projects: list and select projects.llamactl organizations: list organizations.llamactl deployments: create, apply, edit, update, inspect, delete, roll back, and stream deployment logs.llamactl init: create a new LlamaAgents project from a starter template.llamactl serve: run the local app server and optional frontend dev server.llamactl pkg: generate container build files for self-hosted deployments.llamactl completion: generate or install shell completions.llamactl agentcore: run or export AgentCore apps.
Configuration
llamactl auth login and llamactl auth token create local auth profiles. A profile stores the active API environment, project, and credential used by deployment commands.
For CI and other non-interactive environments, set env vars instead of using a profile:
export LLAMA_CLOUD_API_KEY="llx-..."
export LLAMA_AGENTS_PROJECT_ID="project-id"
LLAMA_CLOUD_BASE_URL can point the CLI at a non-default environment. When both LLAMA_CLOUD_API_KEY and LLAMA_AGENTS_PROJECT_ID are set, env var auth takes precedence over the stored profile for cloud commands. Many commands also accept --project to override the active project for that invocation.
Shell Completion
Install completions for your current shell:
llamactl completion install
Or print a completion script:
llamactl completion generate zsh
Requirements
- Python 3.12+
uvfor project dependency managementgitfor cloud deployments
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file llamactl-0.10.2.tar.gz.
File metadata
- Download URL: llamactl-0.10.2.tar.gz
- Upload date:
- Size: 81.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6d05365adc76955bbfdd844d87b3106d16b2c6f41c014fe5d4b49ce831ceb4e3
|
|
| MD5 |
9b51ecfacae3320f54b207010e398eb8
|
|
| BLAKE2b-256 |
c60c1c6cf5d92aa1316b10fbeaa96af493ab880d88ece8dcc71d74c205321626
|
File details
Details for the file llamactl-0.10.2-py3-none-any.whl.
File metadata
- Download URL: llamactl-0.10.2-py3-none-any.whl
- Upload date:
- Size: 106.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0b7285f1ee2752656b98f845ea491d8b8c08c67a693e782940abbc83689e11be
|
|
| MD5 |
48a870e8f3a76c800250c27022218856
|
|
| BLAKE2b-256 |
48fe9b8b4a516ca808237186e4b4a8c667d942ea5cfb1eb27c588ee95b6974ba
|
