---
id: hcloud
version: "2.23.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# hcloud — Official Hetzner Cloud python library

License: permissive · Maintenance: active · Downloads: 247.7K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 247.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

hetzner cloud api client, cloud server management python, infrastructure as code hetzner, hcloud python library, cloud resource provisioning, hetzner api wrapper, cloud automation python, cloud-infrastructure, api-client, hetzner

[View on SkillFed](https://skillfed.io/packages/hcloud) · [View on PyPI](https://pypi.org/project/hcloud/)