Skip to content

v0.1.0

Choose a tag to compare

@danvaneijck danvaneijck released this 10 Feb 08:26
· 17 commits to main since this release
7df90d4

renpho-api v0.1.0

First release of the unofficial Python client for the Renpho Health API.

What it does

Pull body composition measurements from Renpho smart scales — either from the command line or as an imported Python library.

Features

  • RenphoClient — authenticate and fetch measurements from the Renpho cloud API
  • Automatic pagination — get_all_measurements() discovers your scales and pulls everything in one call
  • CLI tool — install and run renpho to export your data as JSON and CSV
  • Export helpers — save_json(), save_csv(), and format_measurement() for working with your data
  • 16 body metrics — weight, BMI, body fat %, water, muscle, bone mass, BMR, visceral fat, subcutaneous fat, protein, body age, lean body mass, fat free weight, heart rate, cardiac index, body shape

Install

pip install renpho-api

Quick start

from renpho import RenphoClient

client = RenphoClient("user@example.com", "password")
measurements = client.get_all_measurements()

for m in measurements:
    print(m["weight"], m.get("bodyfat"))

Or via CLI:

export RENPHO_EMAIL=your@email.com
export RENPHO_PASSWORD=your_password
renpho

Requirements

  • Python 3.10+
  • requests
  • pycryptodome