Libre-linkup-py

TL;DR

Unofficial client to get your glucose readings from the LibreLinkUp API in Python. Supports Python 3.9 and above

Contents

• Installation
• Usage
• Examples
• Contributing

Installation

pip install libre-linkup-py

Usage

Note: I recommend using something like python-dotenv to manage your environment variables.

1. Create a .env file with the following contents:

LIBRE_LINK_UP_USERNAME=...
LIBRE_LINK_UP_PASSWORD=...
LIBRE_LINK_UP_URL=https://api-eu2.libreview.io
LIBRE_LINK_UP_VERSION=4.16.0  # Optional

The url for LIBRE_LINK_UP_URL may be different depending on where you live, current options, also see here for more information.

2. Paste this code into a file and run it:

from libre_link_up import LibreLinkUpClient
import os
import dotenv
import json

dotenv.load_dotenv()

client = LibreLinkUpClient(
    username=os.environ["LIBRE_LINK_UP_USERNAME"],
    password=os.environ["LIBRE_LINK_UP_PASSWORD"],
    url=os.environ["LIBRE_LINK_UP_URL"],
    version="4.16.0",
)
client.login()
glucose_data = client.get_latest_reading()
print(json.dumps(glucose_data.model_dump(), sort_keys=True, indent=4))

The output should look something like:

{
    "high_at_the_time": false,
    "low_at_the_time": false,
    "unix_timestamp": 1709830900.0,
    "value": 7.9,
    "value_in_mg_per_dl": 143.0
}

Examples

See the examples directory for more examples.

Contributing

If you find a bug :bug:, please open a bug report. If you have an idea for an improvement or new feature :rocket:, please open a feature request.