Skip to main content

Module that determines a host's cloud provider

Project description


PyPI - Python Version PyPI PyPI - License Build Status


cloud-detect is a Python module that determines a host's cloud provider. Highly inspired by the Go based Satellite, cloud-detect uses the same techniques (file systems and provider metadata) to properly identify cloud providers.


  • Supports identification of AWS, GCP, Azure and Digital Ocean hosts.
  • Supports skipping providers identification.
  • Logging integration.
  • Small and extensible.


>>> from cloud_detect import provider
>>> provider()
>>> provider(excluded='aws')

Right now the only possible responses are: 'aws', 'gcp', 'do', 'azure' or 'unknown'


Via pip:

pip install cloud-detect


Termination-handler uses cloud-detect to keep the handling of termination notices on spot/preemptible instances cloud-agnostic, making easier to operate the same tooling in various distinct environments.

How to contribute

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
  3. Write a test which shows that the bug was fixed or that the feature works as expected.
  4. Send a pull request and bug me until it gets merged and published.

Some things that would be great to have:

  • Add cloud providers (Vultr, Oracle)
  • Add codecov

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 cloud-detect, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size cloud_detect-0.0.4-py3-none-any.whl (7.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size cloud-detect-0.0.4.tar.gz (3.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page