Need your own package repository for Alpine, Cargo, CocoaPods, Composer, Conan, CRAN, Dart, Debian, Docker, Go, Helm, LuaRocks, Maven, npm, NuGet, Python, RedHat, Ruby, Terraform, Vagrant, Raw & More?

Cloudsmith provides better DevOps with simple and secure delivery of your software, from dev to production.

Start My Free 7-Day Trial
 Open-Source cloudsmith cloudsmith (Cloudsmith) / cli  GitHub Project
Official repository for the Cloudsmith CLI application.
These tend to be pre-releases, for stable releases download from PyPi:
Note: Packages in this repository are licensed as Apache License 2.0 (dependencies may be licensed differently).

Python logo cloudsmith-cli  0.12.0

One-liner (summary)

Cloudsmith Command-Line Interface (CLI)


Cloudsmith Command Line Interface (CLI)

|Latest Version @ Cloudsmith| |Python Versions| |PyPI Version| |CircleCI| |Codacy Badge| |Maintainability| |Test Coverage| |Code style: black|

The Cloudsmith Command Line Interface (CLI) is a Py2/Py3 text-based interface to the API. This allows users, machines and other services to access and integrate smoothly with Cloudsmith without requiring explicit plugins or tools. Be awesome. Automate Everything.

The following (very out of date) GIF demonstrates a small slice of the CLI - View the full video on YouTube:

|CLI Demonstration|

You can also read our blog article that introduced the first version of the CLI and the Cloudsmith RESTful API.


Please see the changelog for the list of changes by version. The current version is displayed in the PyPi badge at the top.


The CLI currently supports the following commands (and sub-commands):

  • check: Check rate limits and service status.
  • copy|cp: Copy a package to another repository.
  • delete|rm: Delete a package from a repository.
  • docs: Launch the help website in your browser.
  • entitlements|ents: Manage the entitlements for a repository.
    • create|new: Create a new entitlement in a repository.
    • delete|rm: Delete an entitlement from a repository.
    • list|ls: List entitlements for a repository.
    • refresh: Refresh an entitlement in a repository.
    • sync: Sync entitlements from another repository.
    • update|set: Update (patch) a entitlement in a repository.
  • help: Display the delightful help message and exit.
  • list|ls: List distros, packages, repos and entitlements.
    • distros: List available distributions.
    • entitlements: List entitlements for a repository.
    • packages: List packages for a repository.
    • repos: List repositories for a namespace (owner).
  • move|mv: Move (promote) a package to another repo.
  • push|upload: Push (upload) a new package to a repository.
    • alpine: Push (upload) a new Alpine package upstream.
    • cargo: Push (upload) a new Cargo package upstream.
    • composer: Push (upload) a new Composer package upstream.
    • cran: Push (upload) a new R/CRAN package upstream.
    • deb: Push (upload) a new Deb package upstream.
    • helm: Push (upload) a new Helm package upstream.
    • luarocks: Push (upload) a new Lua module upstream.
    • maven: Push (upload) a new Maven package upstream.
    • npm: Push (upload) a new Npm package upstream.
    • python: Push (upload) a new Python package upstream.
    • raw: Push (upload) a new Raw package upstream.
    • rpm: Push (upload) a new Rpm package upstream.
    • ruby: Push (upload) a new Ruby package upstream.
    • vagrant: Push (upload) a new Vagrant package upstream.
  • resync: Resynchronise a package in a repository.
  • status: Get the synchronisation status for a package.
  • token: Retrieve your API authentication token/key.
  • whoami: Retrieve your current authentication status.


You can install the latest CLI application from:

The simplest way is to use pip, such as:

pip install --upgrade cloudsmith-cli

Or you can get the latest pre-release version from Cloudsmith:

pip install --upgrade cloudsmith-cli --extra-index-url=


42.8 KB




sdist gz noarch

Status  Completed
Checksum (MD5) 22962e5738d3c7540750b91d2df87435
Checksum (SHA-1) 8290bfc838bdc519fafd9bd2051a3f7703a800bd
Checksum (SHA-256) 78e6496778e6c8f9ab5850b4b9ec06f5313e3b40662b35ace7c58bc91e78d002
Checksum (SHA-512) 27627f8a750045ab3ce02d7bd2aad81222fad5e190204d048f50a6cf5debde0400…
GPG Signature
Storage Region Default Region
Type  Source (contains source code or documentation)
Uploaded At 2 years, 2 months ago
Uploaded By paddycarey-Xvp
Slug Id cloudsmith-cli-0120targz
Unique Id xuMSWSVaPuPV
Version (Raw) 0.12.0
Version (Parsed)
  • Major: 0
  • Minor: 12
  • Patch: 0
  • Type: SemVer (Strict)
  extended metadata
Classifiers Development Status :: 5 - Production/Stable | Environment :: Console | Intended Audience :: Developers | Intended Audience :: System Administrators | License :: OSI Approved :: Apache Software License | Operating System :: POSIX :: Linux | Programming Language :: Python | Programming Language :: Python :: 2 | Programming Language :: Python :: 3 | Topic :: Internet | Topic :: System :: Systems Administration | Topic :: Utilities
Homepage URL
Keywords cloudsmith,cli,devops
Metadata Version 1.1
Platforms any
Py Filetype sdist
pkg cloudsmith-cli-0.12.0.tar.gz 86
42.8 KB
md5 sha1 sha256 sha512
Package Contents (cloudsmith-cli-0.12.0.tar.gz)

This package has 71 files/directories.


You can embed a badge in another website that shows this or the latest version of this package.

To embed the badge for this specific package version, use the following:

[![This version of 'cloudsmith-cli' @ Cloudsmith](;xf=sdist;xn=cloudsmith-cli/?render=true)](;xf=sdist;xn=cloudsmith-cli/)
|This version of 'cloudsmith-cli' @ Cloudsmith|
.. |This version of 'cloudsmith-cli' @ Cloudsmith| image::;xf=sdist;xn=cloudsmith-cli/?render=true
image::;xf=sdist;xn=cloudsmith-cli/?render=true[link=";xf=sdist;xn=cloudsmith-cli/",title="This version of 'cloudsmith-cli' @ Cloudsmith"]
<a href=";xf=sdist;xn=cloudsmith-cli/"><img src=";xf=sdist;xn=cloudsmith-cli/?render=true" alt="This version of 'cloudsmith-cli' @ Cloudsmith" /></a>

rendered as: This version of 'cloudsmith-cli' @ Cloudsmith

To embed the badge for the latest package version, use the following:

[![Latest version of 'cloudsmith-cli' @ Cloudsmith](;xf=sdist;xn=cloudsmith-cli/?render=true&show_latest=true)](;xf=sdist;xn=cloudsmith-cli/)
|Latest version of 'cloudsmith-cli' @ Cloudsmith|
.. |Latest version of 'cloudsmith-cli' @ Cloudsmith| image::;xf=sdist;xn=cloudsmith-cli/?render=true&show_latest=true
image::;xf=sdist;xn=cloudsmith-cli/?render=true&show_latest=true[link=";xf=sdist;xn=cloudsmith-cli/",title="Latest version of 'cloudsmith-cli' @ Cloudsmith"]
<a href=";xf=sdist;xn=cloudsmith-cli/"><img src=";xf=sdist;xn=cloudsmith-cli/?render=true&show_latest=true" alt="Latest version of 'cloudsmith-cli' @ Cloudsmith" /></a>

rendered as: Latest version of 'cloudsmith-cli' @ Cloudsmith

These instructions assume you have setup the repository first (or read it).

To install/use cloudsmith-cli @ version 0.12.0 ...

pip install 'cloudsmith-cli==0.12.0'

You can also install the latest version of this package:

pip install --upgrade 'cloudsmith-cli'

If necessary, you can specify the repository directly:

pip install \
  --extra-index-url= \

If you've got a project requirements.txt file, you can specify this as a dependency:

Warning: We highly recommend using pip (or similar) rather than installing directly.