aioruuvigateway

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 on this page — 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

aioruuvigateway on PyPI

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

Evidence: aioruuvigateway-0.1.0-py3-none-any.whl

Tags

More Internet packages