--- title: "CLI 1.20.0 no longer requires Python" description: "The Cloudsmith CLI now ships as a standalone, self-contained binary for Linux, macOS, and Windows. This eliminates its dependency on a local Python environment. The CLI includes a new one-line installer, a refreshed Homebrew tap and Docker image, and updated GitHub Actions, Azure DevOps, and CircleCI integrations." canonical_url: "https://cloudsmith.com/changelog/cli-1-20-0-no-longer-requires-python" last_updated: "2026-07-30T17:00:01.751Z" --- # CLI 1.20.0 no longer requires Python The Cloudsmith CLI now ships as a standalone, self-contained binary for Linux, macOS, and Windows. This eliminates its dependency on a local Python environment. The CLI includes a new one-line installer, a refreshed Homebrew tap and Docker image, and updated GitHub Actions, Azure DevOps, and CircleCI integrations. ## What’s new The standalone binary bundles everything it needs at runtime. Installation is now a single download-and-verify step that behaves identically across platforms and CI providers. Previously, the CLI was distributed primarily as a Python zipapp (`cloudsmith.pyz`), which requires a compatible Python runtime on any machine and CI runner that uses it. The dependency on a local Python environment often creates extra setup steps, could slow down pipelines, and is susceptible to breaking when the runner's Python version changes. ## How it works For each CLI release, we now publish platform-specific binary archives with SHA-256 checksums, attached to a GitHub release and pushed to Cloudsmith. Linux archives also ship a detached GPG signature. ```json { "_key": "3bbc2a5436c7", "_type": "tableBlock", "firstRowIsHeader": true, "markDefs": null, "table": { "rows": [ { "_key": "9d5f40b5-09f5-4492-93f7-cb1844cbbae2", "_type": "tableRow", "cells": [ "Platform", "Supported architectures" ] }, { "_key": "32455568-f2bf-4686-8e73-e2597ef041f0", "_type": "tableRow", "cells": [ "Linux (glibc and musl)", "x86_64, aarch64" ] }, { "_key": "bc562bbb-c420-43c4-86c5-7a78454aec39", "_type": "tableRow", "cells": [ "macOS", "arm64, x86_64" ] }, { "_key": "46e414e4-4850-4f02-9e72-f6c25c910159", "_type": "tableRow", "cells": [ "Windows", "x86_64" ] } ] } } ``` The standalone binaries replace the cloudsmith.pyz zipapp, which will be deprecated. ### Installation There are 4 supported installation methods: - **Install script**: A new [installer repository](https://github.com/cloudsmith-io/cloudsmith-cli-install-script) includes `install.sh` for Linux/macOS and `install.ps1` for Windows. The install script detects the platform, downloads the right archive, verifies its SHA-256 checksum, and installs the CLI atomically. Each release also attaches a SHA256SUMS file for verifying the scripts themselves. For reproducible CI builds, pin a specific version instead of latest. - **Homebrew**: The tap now installs the standalone binary and no longer depends on Python. Existing installs upgrade transparently with `brew install cloudsmith-io/cloudsmith-cli/cloudsmith`. - **Docker**: The official cloudsmith/cloudsmith-cli [image](https://hub.docker.com/r/cloudsmith/cloudsmith-cli) on Docker Hub now ships the standalone binary on a plain Alpine base. - **Pip:** If you prefer to run in your own Python environment, you still can do so, via `pip install cloudsmith-cli`. For more details, see [Command-Line Interface: Installation](https://docs.cloudsmith.com/developer-tools/cli#installation). ### Updated CI/CD integrations Each CI/CD integration for the Cloudsmith CLI now installs the standalone CLI and supports API key and CLI-native OIDC authentication, with no Python or additional dependencies on the runner. ```json { "_key": "d69ed178fc7d", "_type": "callout", "content": [ { "_key": "d8fa32771021", "_type": "block", "children": [ { "_key": "e481733779af", "_type": "span", "marks": [], "text": "These are major releases with breaking changes. Existing integrations will continue to work normally until you update to v1.20.0." } ], "markDefs": [], "style": "normal" } ], "markDefs": null, "variant": "warning" } ``` ```json { "_key": "47e47902651a", "_type": "tableBlock", "firstRowIsHeader": true, "markDefs": null, "table": { "rows": [ { "_key": "083271c6-3a43-4041-b336-b6d41079d27a", "_type": "tableRow", "cells": [ "CI/CD integration", "New version", "Highlights" ] }, { "_key": "6362a70d-48a7-47c2-a7a2-f04f47786c39", "_type": "tableRow", "cells": [ "GitHub Actions", "v3", "Composite action; Linux, macOS, and Windows runners with ARM64 support; exposes CLI path and version outputs." ] }, { "_key": "73fd515f-d53d-4a20-844b-4763e09c7d8d", "_type": "tableRow", "cells": [ "Azure DevOps", "@2", "Consistent install across Linux, macOS, and Windows agents; existing @1 pipelines keep working until you opt in." ] }, { "_key": "9cf5495f-ea71-462f-b2a8-ea2dff1605e4", "_type": "tableRow", "cells": [ "CircleCI orb", "3.0.0", "Smaller cimg/base default executor; publish with 'cloudsmith push' directly." ] } ] } } ``` For migration steps and examples, see the guide for your integration: - [GitHub Actions: Migrating from v2](https://github.com/cloudsmith-io/cloudsmith-cli-action#migrating-from-v2) - [Azure DevOps: Migrating from 1 to 2](https://github.com/cloudsmith-io/cloudsmith-ado-integration#migrating-from-1-to-2) - [CircleCI orb: Migrating from v2](https://github.com/cloudsmith-io/orb#migrating-from-v2) ## Action items - **Update tooling to use the [cloudsmith/cli](https://broadcasts.cloudsmith.com/cloudsmith/cli) repository**: Cloudsmith now publishes our CLI artifacts (binaries, Docker images, and Python wheels) to the [cli](https://broadcasts.cloudsmith.com/cloudsmith/cli) repository. We are deprecating the existing [cli-zipapp](https://broadcasts.cloudsmith.com/cloudsmith/cli-zipapp) repository, so you should update any tooling that pulls from the deprecated repository. - **Update CI/CD integrations for [GitHub Actions](https://github.com/cloudsmith-io/cloudsmith-cli-action), [Azure DevOps](https://marketplace.visualstudio.com/items?itemName=Cloudsmith.CloudsmithCliSetupAndAuthenticate), and [Circle CI orb](https://github.com/cloudsmith-io/orb): **The new CI/CD integrations for GitHub Actions, Azure DevOps, and CircleCI orb are major releases with breaking changes. Update your integrations with the migration guide for each. - **Remove unused Homebrew dependency:** `brew upgrade` handles the upgrade transition automatically. After upgrading, you may have an orphaned python@3.10 dependency, which you can remove with `brew autoremove`.