Skip to main content

Exploit DigitalOcean API through the console.

Project description


ReadTheDocs documentation status Latest PyPI version Travis CI build status Codecov status Supported Python versions Project's licence

Create DigitalOcean droplets like a breeze through the command line.


You may read the full documentation on ReadTheDocs.


Before installing this package make sure you have an account to Digital Ocean and have obtained a Digital Ocean API token The recommended way of storing the token is via environment variable. Once you copy it, do the following:

$ vim ~/.profile or nano ~/.profile
# make sure the following line is added
$ export DO_TOKEN="API TOKEN HERE"  # or other name than DO_TOKEN
$ source ~/.profile


Installation is just a pip install away:

(virtualenv_name) $ pip install beauty-ocean

You are using virtualenv, don’t you? If not, install it inside your ~/.local directory.

$ pip install --user beauty-ocean

Never ever use sudo!


For the moment, this package implements the creation of Digital Ocean droplets but very soon it will support the creation of Domains and Networks. Once installed, the droplet command will be available at your disposal. It accepts a single option --token or -t for short. Defaults to "DO_TOKEN" which is the name of the environment variable that you created earlier. If you used a different name then pass that name to the -t option.

$ droplet

# or
$ droplet -t MY_ENV_NAME_FOR_TOKEN

You may, also, pass a file path to the -t option where this file holds the token only.

$ droplet --t path/to/file/that/holds/the/token

Lastly, but not recommended, you may pass directly, to the -t option, the token itself.


Once the token is resolved, a series of questions will be initiated in order to get the available data from you, submit this data to the Digital Ocean API and create the droplet. All the above come in a good-looking format of questions.

Finally, a json string will be returned with all the droplet data at your disposal to use it in any way you want.


  • Beautiful command-line-interface questions flow with sensible defaults
  • Supports remote or local SSH keys addition and/or remote/local Tags


An mp4 video demo can be found here.


This package was created using:


I do not work at DigitalOcean, neither have any benefits (financial or professional) from creating this package. This package was created because it facilitates my workflow during droplet creation and website deployment and I wanted to share it with other developers. Sharing is a good thing!


0.2.1 (2020-1-17)

  • Fix a bug (NotFoundError) produced while creating the droplet.

0.1.4 (2019-04-05)

  • Fix exception occurred when token was imported by a file.

0.1.3 (2018-09-18)

  • Fix create_droplet function which did not return JSON data. Now it does.

0.1.2 (2018-09-17)

  • Fix Pipenv file and include Pipfile* files into the source distribution.

0.1.1 (2018-09-16)

  • Added check-manifest package and fix bump2version version error.

0.1.0 (2018-09-15)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for beauty-ocean, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size beauty_ocean-0.2.1-py3-none-any.whl (16.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size beauty_ocean-0.2.1.tar.gz (1.4 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page