hcloud

What it is and what it does

Hcloud is the official Python SDK for Hetzner Cloud, a cloud infrastructure provider. It wraps Hetzner's REST API in a Python-native interface, allowing you to create, manage, and query cloud servers, images, networks, volumes, and other infrastructure resources programmatically. The library handles authentication, request formatting, and response parsing, so you work with Python objects rather than raw HTTP calls.

The package is production-stable (Development Status 5) and actively maintained, with support for Python 3.10 through 3.14. It has minimal dependencies—only requests for HTTP and python-dateutil for timestamp handling—making it lightweight to integrate. The library includes experimental features that may have breaking changes within minor releases, so you should monitor the API changelog for updates to features marked experimental.

Use it for:

• Automate server provisioning and teardown as part of deployment or testing pipelines.
• Build infrastructure-as-code tools that manage Hetzner Cloud resources declaratively.
• Query and monitor your cloud infrastructure programmatically for cost tracking or compliance audits.
• Integrate Hetzner Cloud resource management into larger orchestration or DevOps workflows.
• Develop multi-cloud or hybrid-cloud applications that need to manage Hetzner resources alongside other providers.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Hcloud is the official Python client library for Hetzner Cloud's API, enabling programmatic management of cloud infrastructure including servers, images, and other resources.

Yes. Hcloud is the official, actively maintained library for Hetzner Cloud integration. It has low install friction, permissive licensing, no known vulnerabilities, and is production-stable. Install it if you need to manage Hetzner Cloud infrastructure from Python. Be aware that experimental features may change within minor releases—monitor the changelog if you rely on them.

Install

hcloud on PyPI

pip install hcloud

uv add hcloud

poetry add hcloud

Installing hcloud

Before you install

Low install friction with a pure-Python wheel distribution. The package is actively maintained with a release 24 days ago and supports current Python versions (3.10 through 3.14). Depends only on two common libraries: requests and python-dateutil.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute this library freely in commercial and private projects with minimal restrictions.

Quickstart

pip install hcloud

from hcloud import Client
from hcloud.images import Image
from hcloud.server_types import ServerType

client = Client(token="YOUR_API_TOKEN", application_name="my-app")
response = client.servers.create(
    name="my-server",
    server_type=ServerType(name="cx23"),
    image=Image(name="ubuntu-22.04")
)
print(response.server.id)

Requires a valid Hetzner Cloud API token to authenticate with the service.

Verify before relying

• Whether experimental features in the library are suitable for production use in your specific use case.
• Performance characteristics and rate limits when managing large numbers of cloud resources.

Package facts

Evidence: hcloud-2.23.0-py3-none-any.whl

Keywords: hcloud, hetzner, cloud

Tags

More Internet packages