Need your own package repository for
Alpine, Cargo, CocoaPods, Composer, CRAN, Dart, Debian, Docker, Go, Helm, LuaRocks, Maven, npm, NuGet, Python, RedHat, Ruby, 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
Set Me Up
 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).
bdist/wheel whl noarch py2/py3

cloudsmith-cli  0.17.2


Python logo Python (python)


 Sync Completed


Apache License 2.0


64.9 KB




lskillen Lee Skillen

One-liner (summary)

Cloudsmith Command-Line Interface (CLI)


Cloudsmith Command Line Interface (CLI)

|Latest Version @ Cloudsmith| |Python Versions| |PyPI Version| |CircleCI| |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).
  • login|token: Retrieve your API authentication token/key via login.
  • 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 Debian package upstream.
  • docker: Push (upload) a new Docker image upstream.
  • go: Push (upload) a new Go module 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.
  • nuget: Push (upload) a new NuGet package upstream.
  • python: Push (upload) a new Python package upstream.
  • raw: Push (upload) a new Raw package upstream.
  • rpm: Push (upload) a new RedHat 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.
  • 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:

Uploaded At 5 months, 2 weeks ago
Unique Id QPxhovCaUWwj
Sequential Id 56
Package cloudsmith-cli
Version 0.17.2
Storage Region  Dublin, Ireland
Type  Binary (contains binaries and binary artifacts)
License Apache License 2.0
MD5 744200c85535cba6f6f744091d3c535e
SHA-1 df3128ce29ed4f3be72492f56ec779c83bb7777f
SHA-256 4004422d9e4ead5330d44a6bec2940b176cae6ea5eaeb1a4b942bbf5d4bbda15
SHA-512 adffd253242807d21c99e9c4a51c34b5ce8c0d20a01a27208505a6feb14e923aa0…
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 2.1
Platforms any
Py Filetype bdist_wheel
Py Version py2.py3
pkg cloudsmith_cli-0.17.2-py2.py3-n… 48
64.9 KB
md5 sha1 sha256 sha512
Package Contents (cloudsmith_cli-0.17.2-py2.py3-none-any.whl)

This package has 65 files/directories.

 Newer Python logo
cloudsmith-cli 0.20.1
bdist/wheel whl noarch py2/py3 latest 63.1 KB 4 days, 10 hours ago
1 lskillen
 Newer Python logo
cloudsmith-cli 0.20.0
bdist/wheel whl noarch py2/py3 65.0 KB 1 week ago
2 lskillen
 Newer Python logo
cloudsmith-cli 0.18.0
bdist/wheel whl noarch py2/py3 65.0 KB 3 months, 2 weeks ago
24 lskillen
 Newer Python logo
cloudsmith-cli 0.17.3
bdist/wheel whl noarch py2/py3 64.9 KB 5 months, 2 weeks ago
58 lskillen
 Same Python logo
cloudsmith-cli 0.17.2
bdist/wheel whl noarch py2/py3 64.9 KB 5 months, 2 weeks ago
48 lskillen
 Older Python logo
cloudsmith-cli 0.17.1
bdist/wheel whl noarch py2/py3 64.9 KB 6 months ago
63 lskillen
 Older Python logo
cloudsmith-cli 0.17.0
bdist/wheel whl noarch py2/py3 64.9 KB 6 months, 2 weeks ago
77 lskillen
 Older Python logo
cloudsmith-cli 0.16.0
bdist/wheel whl noarch py2/py3 62.3 KB 6 months, 2 weeks ago
74 lskillen
 Older Python logo
cloudsmith-cli 0.15.0
bdist/wheel whl noarch py2/py3 62.4 KB 7 months ago
70 lskillen
 Older Python logo
cloudsmith-cli 0.14.0
bdist/wheel whl noarch py2/py3 62.4 KB 7 months, 1 week ago
85 lskillen
 Older Python logo
cloudsmith-cli 0.12.0
27 paddycarey
 Older Python logo
cloudsmith-cli 0.12.0
bdist/wheel whl noarch py2/py3 62.1 KB 7 months, 3 weeks ago
69 paddycarey
 Older Python logo
cloudsmith-cli 0.11.0
bdist/wheel whl noarch py2/py3 62.0 KB 7 months, 3 weeks ago
95 paddycarey
 Older Python logo
cloudsmith-cli 0.11.0
24 paddycarey
 Older Python logo
cloudsmith-cli 0.10.0
bdist/wheel whl noarch py2/py3 62.0 KB 11 months, 2 weeks ago
85 paddycarey
 Older Python logo
cloudsmith-cli 0.9.0
bdist/wheel whl noarch py2/py3 61.9 KB 11 months, 3 weeks ago
96 lskillen
 Older Python logo
cloudsmith-cli 0.8.2
bdist/wheel whl noarch py2/py3 61.9 KB 1 year ago
88 lskillen
 Older Python logo
cloudsmith-cli 0.8.1
bdist/wheel whl noarch py2/py3 61.9 KB 1 year ago
92 lskillen
 Older Python logo
cloudsmith-cli 0.8.0
bdist/wheel whl noarch py2/py3 61.9 KB 1 year ago
86 lskillen
 Older Python logo
cloudsmith-cli 0.7.2
bdist/wheel whl noarch py2/py3 62.6 KB 1 year, 1 month ago
113 lskillen
 Older Python logo
cloudsmith-cli 0.7.1
bdist/wheel whl noarch py2/py3 62.5 KB 1 year, 1 month ago
106 lskillen
 Older Python logo
cloudsmith-cli 0.7.0
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 5 months ago
132 lskillen
 Older Python logo
cloudsmith-cli 0.6.3
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 7 months ago
141 lskillen
 Older Python logo
cloudsmith-cli 0.6.2
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 7 months ago
129 lskillen
 Older Python logo
cloudsmith-cli 0.6.1
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 8 months ago
141 lskillen

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 @ Cloudsmith](;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iy8YIWKDQ1oL5Q2kuEIqYTbs2uDlXKuPArZ1H1cFvXXH05qK-HEmYY-JBHdXT4AKQGstf52j8XSK42sv0UdJz05N70_qU6PBVcfaDW_E8q0_A%3D)](;xn=cloudsmith-cli;xv=py2.py3/)
|This Version @ Cloudsmith|
.. |This Version @ Cloudsmith| image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iy8YIWKDQ1oL5Q2kuEIqYTbs2uDlXKuPArZ1H1cFvXXH05qK-HEmYY-JBHdXT4AKQGstf52j8XSK42sv0UdJz05N70_qU6PBVcfaDW_E8q0_A%3D
image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iy8YIWKDQ1oL5Q2kuEIqYTbs2uDlXKuPArZ1H1cFvXXH05qK-HEmYY-JBHdXT4AKQGstf52j8XSK42sv0UdJz05N70_qU6PBVcfaDW_E8q0_A%3D[link=";xn=cloudsmith-cli;xv=py2.py3/",title="This Version @ Cloudsmith"]
<a href=";xn=cloudsmith-cli;xv=py2.py3/"><img src=";xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iy8YIWKDQ1oL5Q2kuEIqYTbs2uDlXKuPArZ1H1cFvXXH05qK-HEmYY-JBHdXT4AKQGstf52j8XSK42sv0UdJz05N70_qU6PBVcfaDW_E8q0_A%3D" alt="This Version @ Cloudsmith" /></a>

rendered as: This Version @ Cloudsmith

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

[![Latest Version @ Cloudsmith](;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iySEZnG-sGXyaTLNWVHXKdkI4b0H8U23_obRCSYaRE1dWvmnBuc6sP2cdxNQd0jvTWEMIfT2yWL099pnWtm56MeiVXHZSLD2mKpkrzq3KkQB4%3D)](;xn=cloudsmith-cli;xv=py2.py3/)
|Latest Version @ Cloudsmith|
.. |Latest Version @ Cloudsmith| image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iySEZnG-sGXyaTLNWVHXKdkI4b0H8U23_obRCSYaRE1dWvmnBuc6sP2cdxNQd0jvTWEMIfT2yWL099pnWtm56MeiVXHZSLD2mKpkrzq3KkQB4%3D
image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iySEZnG-sGXyaTLNWVHXKdkI4b0H8U23_obRCSYaRE1dWvmnBuc6sP2cdxNQd0jvTWEMIfT2yWL099pnWtm56MeiVXHZSLD2mKpkrzq3KkQB4%3D[link=";xn=cloudsmith-cli;xv=py2.py3/",title="Latest Version @ Cloudsmith"]
<a href=";xn=cloudsmith-cli;xv=py2.py3/"><img src=";xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeh7iySEZnG-sGXyaTLNWVHXKdkI4b0H8U23_obRCSYaRE1dWvmnBuc6sP2cdxNQd0jvTWEMIfT2yWL099pnWtm56MeiVXHZSLD2mKpkrzq3KkQB4%3D" alt="Latest Version @ Cloudsmith" /></a>

rendered as: Latest Version @ Cloudsmith

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

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

pip install 'cloudsmith-cli==0.17.2'

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.