---
id: aioruuvigateway
version: "0.1.0"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# aioruuvigateway

License: unclear · Maintenance: dormant · Downloads: 109.1K/mo

## What it is and what it does

aioruuvigateway is a Python asyncio library for communicating with Ruuvi Gateway devices via HTTP. It handles bearer token authentication and can fetch sensor data from the gateway, optionally parsing and formatting it as JSON. The library depends on httpx for async HTTP requests and bluetooth-data-tools for data handling.

The package is in beta status and supports Python 3.7 through 3.11 on CPython and PyPy. It provides both a programmatic API (documented in test_library.py) and a command-line interface for testing and data retrieval. However, the project is dormant—no releases since April 2023 and last commit in June 2024—so it receives no active maintenance or updates.

Use it for:

- Fetch sensor readings from a Ruuvi Gateway in an async Python application without blocking.
- Monitor Ruuvi sensor data periodically and export it as JSON for logging or integration with other systems.
- Build a home automation or IoT monitoring script that polls a Ruuvi Gateway at regular intervals.

## Worth the install?

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

An asyncio-native library for fetching data from Ruuvi Gateway devices over HTTP, with bearer token authentication and optional JSON output formatting.

Yes, if you own a Ruuvi Gateway and need async Python integration with low install friction and no known vulnerabilities. No, if you need active maintenance or recent updates—the project is dormant and the license treatment is unclear, creating minor legal ambiguity. Consider it a working but unsupported tool.

## Install

pip install aioruuvigateway
uv add aioruuvigateway
poetry add aioruuvigateway

## Installing aioruuvigateway

Before you install: Low install friction with only two runtime dependencies (bluetooth-data-tools and httpx). Maintenance is dormant—last commit was 2024-06-24 and no releases since 2023-04-16—so expect no active bug fixes or updates.

License in practice: License treatment is unclear; the description states MIT but the fact sheet records no SPDX identifier or raw license field, creating ambiguity about actual licensing terms and obligations.

Quickstart:

pip install aioruuvigateway

python -m aioruuvigateway --host 192.168.1.249 --token bearbear --parse --json

Requires Python 3.7 or newer and a Ruuvi Gateway device with bearer token authentication configured.

Verify before relying:

- Whether the MIT license claim in the description is authoritative given the unclear license_treatment in metadata.
- Whether bluetooth-data-tools dependency is actually required at runtime or only for certain features.
- Current stability and compatibility of the package with modern Ruuvi Gateway firmware versions.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 109.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ruuvi gateway client, asyncio ruuvi data, ruuvi sensor gateway, async http gateway, ruuvi device integration, iot-sensor, asyncio

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