---
id: pyhiveapi
version: "0.5.16"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyhiveapi — A Python library to interface with the Hive API

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

## What it is and what it does

pyhive-integration is a Python client library for the Hive smart home platform, providing both async and sync APIs to discover, monitor, and control Hive devices (thermostats, hot water, lights, plugs, sensors, and hubs). It handles AWS Cognito SRP authentication with optional SMS two-factor authentication, automatic token refresh, and a polling-based device cache. The library is designed primarily for Home Assistant integration but works standalone.

The package ships two entry points: one async and one sync, both built from the same source. It supports a wide range of Hive device types with granular control and includes a file-based offline mode for testing without live credentials. Eight runtime dependencies (boto3, requests, aiohttp, loguru, and others) handle authentication, HTTP communication, and logging.

Use it for:

- Integrate Hive heating and hot water control into Home Assistant automations and dashboards.
- Build standalone Python scripts to monitor and control Hive devices on a schedule.
- Develop a custom smart home dashboard that queries Hive device state and sends commands.
- Test Hive device logic and integrations offline using the file-based fixture mode without real credentials.
- Automate lighting control (brightness, color, on/off) based on external events or time-based rules.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python library for controlling Hive smart home devices (heating, hot water, lights, plugs, sensors) via the Hive API, with both async and sync interfaces.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides a dual async/sync API for Hive smart home control. Low install friction and stable status make it a safe choice for Home Assistant users or standalone Hive automation. Verify the Python version requirement before installing.

## Install

pip install pyhiveapi
uv add pyhiveapi
poetry add pyhiveapi

## Installing pyhiveapi

Before you install: Low install friction with a pure-Python wheel. Actively maintained with a recent commit (2026-08-07) and stable status. Eight runtime dependencies are all well-established libraries (boto3, requests, aiohttp, loguru, etc.), so dependency resolution should be straightforward.

License in practice: MIT license (permissive) means you can use, modify, and distribute this library freely in commercial and private projects with minimal restrictions — just include the license notice.

Quickstart:

from pyhiveapi import Auth, Hive

auth = Auth(username="user@example.com", password="yourpassword")
tokens = auth.login()
hive = Hive(username="user@example.com", password="yourpassword")
hive.startSession({"tokens": tokens})
for device in hive.session.data.devices.values():
    print(device)

Hive account credentials (username/password) are required; guest accounts are not supported. Verify your Python version matches the actual minimum requirement.

Verify before relying:

- Classifiers declare support for Python 3.6–3.9, but description states 'Requires Python 3.10+'; which is the actual minimum?
- Whether the package works standalone outside Home Assistant as claimed, or if Home Assistant integration is a primary use case with limitations elsewhere.
- Performance characteristics and polling frequency tuning options for large device counts or high-frequency state updates.
- Exact capabilities and control options for each device type (heating, hot water, lights, plugs, sensors, hub/sense).

## Package facts

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

## Tags

hive smart home api, hive thermostat control python, hive device integration, smart home automation library, hive home assistant integration, async smart home api, hive heating and lighting control, smart-home, iot-integration, async-first

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