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 Alibaba, 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: 'alibaba', 'aws', 'gcp', 'do', 'azure', 'oci' 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)
  • Add codecov

Cloud Detect

Module that determines a host's cloud provider.

Cloud Detect Info

⭐ Stars 25
🔗 Homepage
🔗 Source Code
🕒 Last Update 6 months ago
🕒 Created 3 years ago
🐞 Open Issues 2
➗ Star-Issue Ratio 13
😎 Author dgzlopes