Need your own package repository for
Alpine, Cargo, 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.2.2


Python logo Python (python)


 Sync Completed


Apache License 2.0


39.0 KB




lskillen Lee Skillen

One-liner (summary)

Cloudsmith Command-Line Interface (CLI)


Cloudsmith Command Line Interface (CLI)

|Python Versions| |PyPI Version| |Travis| |Codecov| |Gemnasium| |Codacy|

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 (slightly 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 currently version is displayed in the PyPi badge at the top.


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

  • check: Check the status/version of the service.
  • delete: Delete a package from a repository.
  • docs: Launch the help website in your browser.
  • help: Display the help message and exit.
  • list: List distributions, packages and repos.
  • distros: List available distributions.
  • packages: List packages for a repository.
  • repos: List repositories for a namespace (owner).
  • push: Push/upload a new package to a repository.
  • deb: Push/upload a new Deb package upstream.
  • maven: Push/upload a new Maven 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.
  • 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 cloudsmith-cli

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

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


There are two configuration files used by the CLI:

  • config.ini: For non-credentials configuration.
  • credentials.ini: For credentials (authentication) configuration.

By default, the CLI will look for these in the following locations:

  • The current working directory.
  • A directory called cloudsmith in the OS-defined application directory. For example:
  • Linux: $HOME/.config/cloudsmith
    • Windows: C:\Users\YourName\AppData\cloudsmith

Both configuration files use the simple INI format, such as:


Non-Credentials (config.ini)

See the default example in GitHub:

You can specify the following configuration options:

  • api_host: The API host to connect to.
  • api_proxy: The API proxy to connect through.
  • api_user_agent: The user agent to use for requests.

Credentials (credentials.ini)

See the default example in GitHub:

You can specify the following configuration options:

  • api_key: The API key for authenticating with
Uploaded At 2 years, 1 month ago
Unique Id yMGhw8E5Z1YJ
Sequential Id 4
Package cloudsmith-cli
Version 0.2.2
Type  Binary (contains binaries and binary artifacts)
License Apache License 2.0
MD5 3f4dd5edaa9697469addc121823194d7
SHA-1 e31e8555372374d6bc76fe753d08334e5575a418
SHA-256 07bcc1582eb711ac00001e47b42f0b69ab5e6efd64c78b2d39f78df0361af166
SHA-512 76b035ac101dd1dedf2e5f25e80977579cf41020758ef221c0e630d171e566d4f6…
Author Cloudsmith Ltd <>
Classifiers Development Status :: 3 - Alpha | 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.0
Platforms any
Py Filetype bdist_wheel
Py Version py2.py3
pkg cloudsmith_cli-0.2.2-py2.py3-no… 167
39.0 KB
md5 sha1 sha256 sha512
Package Contents (cloudsmith_cli-0.2.2-py2.py3-none-any.whl)

This package has 56 files/directories.

 Newer Python logo
cloudsmith-cli 0.9.0
bdist/wheel whl noarch py2/py3 61.9 KB 9 months ago
79 lskillen
 Newer Python logo
cloudsmith-cli 0.8.2
bdist/wheel whl noarch py2/py3 61.9 KB 9 months, 2 weeks ago
78 lskillen
 Newer Python logo
cloudsmith-cli 0.8.1
bdist/wheel whl noarch py2/py3 61.9 KB 9 months, 2 weeks ago
80 lskillen
 Newer Python logo
cloudsmith-cli 0.8.0
bdist/wheel whl noarch py2/py3 61.9 KB 9 months, 2 weeks ago
73 lskillen
 Newer Python logo
cloudsmith-cli 0.7.2
bdist/wheel whl noarch py2/py3 62.6 KB 11 months ago
100 lskillen
 Newer Python logo
cloudsmith-cli 0.7.1
bdist/wheel whl noarch py2/py3 62.5 KB 11 months, 1 week ago
93 lskillen
 Newer Python logo
cloudsmith-cli 0.7.0
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 3 months ago
116 lskillen
 Newer Python logo
cloudsmith-cli 0.6.3
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 5 months ago
129 lskillen
 Newer Python logo
cloudsmith-cli 0.6.2
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 5 months ago
116 lskillen
 Newer Python logo
cloudsmith-cli 0.6.1
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 5 months ago
125 lskillen
 Newer Python logo
cloudsmith-cli 0.6.0
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 5 months ago
124 lskillen
 Newer Python logo
cloudsmith-cli 0.5.7
bdist/wheel whl noarch py2/py3 59.3 KB 1 year, 8 months ago
140 lskillen
 Newer Python logo
cloudsmith-cli 0.5.6
bdist/wheel whl noarch py2/py3 59.2 KB 1 year, 9 months ago
154 lskillen
 Newer Python logo
cloudsmith-cli 0.5.5
bdist/wheel whl noarch py2/py3 59.2 KB 1 year, 9 months ago
152 lskillen
 Newer Python logo
cloudsmith-cli 0.5.4
bdist/wheel whl noarch py2/py3 59.2 KB 1 year, 9 months ago
149 lskillen
 Newer Python logo
cloudsmith-cli 0.5.3
bdist/wheel whl noarch py2/py3 59.2 KB 1 year, 9 months ago
157 lskillen
 Newer Python logo
cloudsmith-cli 0.5.2
bdist/wheel whl noarch py2/py3 59.1 KB 1 year, 9 months ago
142 lskillen
 Newer Python logo
cloudsmith-cli 0.5.1
bdist/wheel whl noarch py2/py3 59.1 KB 1 year, 9 months ago
140 lskillen
 Newer Python logo
cloudsmith-cli 0.4.1
bdist/wheel whl noarch py2/py3 43.6 KB 1 year, 10 months ago
160 lskillen
 Newer Python logo
cloudsmith-cli 0.3.4
bdist/wheel whl noarch py2/py3 41.9 KB 1 year, 10 months ago
150 lskillen
 Newer Python logo
cloudsmith-cli 0.3.2
bdist/wheel whl noarch py2/py3 41.8 KB 2 years ago
152 lskillen
 Newer Python logo
cloudsmith-cli 0.3.1
bdist/wheel whl noarch py2/py3 41.6 KB 2 years, 1 month ago
170 lskillen
 Newer Python logo
cloudsmith-cli 0.3.0
bdist/wheel whl noarch py2/py3 42.1 KB 2 years, 1 month ago
156 lskillen
 Same Python logo
cloudsmith-cli 0.2.2
bdist/wheel whl noarch py2/py3 39.0 KB 2 years, 1 month ago
167 lskillen
 Older Python logo
cloudsmith-cli 0.1.0
bdist/wheel whl noarch py2/py3 27.3 KB 2 years, 1 month ago
164 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=gAAAAABeIp1T7gBB-9XLqeeNPyjT6HRJXRjGXgqewdluXsrF2F8MoZuZr5kC6r-OHwzm7b76JaAuBLN91ASFEXvzkhXt189B1lf5t9ITvDlyenm1kQRjrMQ%3D)](;xn=cloudsmith-cli;xv=py2.py3/)
|This Version @ Cloudsmith|
.. |This Version @ Cloudsmith| image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeIp1T7gBB-9XLqeeNPyjT6HRJXRjGXgqewdluXsrF2F8MoZuZr5kC6r-OHwzm7b76JaAuBLN91ASFEXvzkhXt189B1lf5t9ITvDlyenm1kQRjrMQ%3D
image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeIp1T7gBB-9XLqeeNPyjT6HRJXRjGXgqewdluXsrF2F8MoZuZr5kC6r-OHwzm7b76JaAuBLN91ASFEXvzkhXt189B1lf5t9ITvDlyenm1kQRjrMQ%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=gAAAAABeIp1T7gBB-9XLqeeNPyjT6HRJXRjGXgqewdluXsrF2F8MoZuZr5kC6r-OHwzm7b76JaAuBLN91ASFEXvzkhXt189B1lf5t9ITvDlyenm1kQRjrMQ%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=gAAAAABeIp1TSUiNCtKABhF0CIqueX66eHo7B_4aYSIu1_XVDCYzAJm0Jj0G8wnY25r0ldtKfRM6b6KlY1wvLAv-lAV9R_CCroyw7-lq3BNLEQqtwKIwkog%3D)](;xn=cloudsmith-cli;xv=py2.py3/)
|Latest Version @ Cloudsmith|
.. |Latest Version @ Cloudsmith| image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeIp1TSUiNCtKABhF0CIqueX66eHo7B_4aYSIu1_XVDCYzAJm0Jj0G8wnY25r0ldtKfRM6b6KlY1wvLAv-lAV9R_CCroyw7-lq3BNLEQqtwKIwkog%3D
image::;xn=cloudsmith-cli;xv=py2.py3/?render=true&badge_token=gAAAAABeIp1TSUiNCtKABhF0CIqueX66eHo7B_4aYSIu1_XVDCYzAJm0Jj0G8wnY25r0ldtKfRM6b6KlY1wvLAv-lAV9R_CCroyw7-lq3BNLEQqtwKIwkog%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=gAAAAABeIp1TSUiNCtKABhF0CIqueX66eHo7B_4aYSIu1_XVDCYzAJm0Jj0G8wnY25r0ldtKfRM6b6KlY1wvLAv-lAV9R_CCroyw7-lq3BNLEQqtwKIwkog%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.2.2 ...

pip install 'cloudsmith-cli==0.2.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.