tiremo-sdk-client 0.1.0

Python client for the TIREMO SDK REST and live WebSocket APIs

tiremo-sdk-client

Official Python client for the TIREMO SDK — REST bootstrap plus an async WebSocket live channel for telemetry, presence, and alarms.

Requires Python 3.10+.

Documentation

Topic	Link
SDK Live Data	docs.tiremo.ai/developer-guide/sdk-live-data
API Key Security	docs.tiremo.ai/developer-guide/sdk-api-key-security
Source & issues	TIREMO-SDK-CLIENT

Install

pip install tiremo-sdk-client

From source (development):

make venv lint    # creates .venv and installs editable package
# or from repo root: make install-python

pip install .

Usage

import asyncio

from tiremo_sdk import TiremoClient

async def main() -> None:
    client = TiremoClient(
        api_key="your-api-key",
        base_url="https://sdk.tiremo.ai",
    )

    latest = await client.get_telemetry_latest("device-123", keys=["temperature"])
    print(latest)

    token_response = await client.create_live_token()
    live = client.connect_live_with_token(token_response["token"])

    async def on_telemetry(event: dict) -> None:
        print(event["data"])

    live.on("telemetry", on_telemetry)
    await live.connect()
    await live.subscribe_telemetry("temp", "device-123", keys=["temperature"])
    await asyncio.sleep(60)
    await live.disconnect()

asyncio.run(main())

Related packages

Package	Use case
@empa-electronics/tiremo-sdk-client-js	Browser / bundler
@empa-electronics/tiremo-sdk-client-node	Node.js 18+

Release

Uses a local .venv (Python 3.12 by default — avoids Homebrew 3.14 pyexpat issues on macOS).

make venv
export TWINE_USERNAME=__token__
export TWINE_PASSWORD=<pypi-api-token>
make release    # bumps patch in pyproject.toml, builds, uploads

To bump version only: make patch

CI: bump version in pyproject.toml, commit, push tag client-python/v<version> (PyPI Trusted Publishing → workflow publish-client-python.yml).

License

ISC — Empa Electronics