Skip to main content

SweatStack Python SDK

The official Python client for SweatStack, the sports data platform: one API for activities, time series, lab tests and daily measures from every wearable.

Install

uv add "sweatstack[polars]"     # analysis with Polars
uv add "sweatstack[pandas]"     # analysis with pandas
uv add sweatstack               # models only: FastAPI services, webhook consumers

Other extras: [arrow] (DuckDB), [streamlit] and [fastapi] (sign-in helpers). Extras combine: sweatstack[polars,arrow].

Quickstart

from sweatstack import Client

client = Client()
client.authenticate()  # opens the browser once; the sign-in is saved for later runs

latest = client.activities.latest()
if latest is None:
    raise SystemExit("No activities yet: connect a wearable at https://app.sweatstack.no")
print(latest.sport, latest.start_local)

data = client.activities.data(latest.id, metrics=["power", "heart_rate"])
print(data.head())

Every endpoint group is an attribute named after its URL: /api/v1/activities/... is client.activities, /api/v1/tests/... is client.tests. Collections take output= ("polars", "pandas", "arrow") for a frame instead of models.

In a script or notebook, the module-level functions use one shared client: sweatstack.activities.list(). In an app that serves several users, use one Client per user, such as the ones the FastAPI and Streamlit helpers give you.

For coding agents

Install the SDK's agent skill for Claude Code, Cursor, Codex and other agents:

npx skills add SweatStack/sweatstack-python

Documentation

Sports follow OpenSportTaxonomy: sweatstack.Sport is its Sport type.

Metadata

Release files for sweatstack 0.99.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sweatstack 0.99.0
File Size Uploaded Provenance Actions
sweatstack-0.99.0.tar.gz 448.2 kB Without provenance Details for sweatstack-0.99.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sweatstack 0.99.0
File Interpreter ABI Platform Actions
sweatstack-0.99.0-py3-none-any.whl Python 3 none any Details for sweatstack-0.99.0-py3-none-any.whl

Total release size: 558.2 kB

Release files / sweatstack-0.99.0.tar.gz

Download URL sweatstack-0.99.0.tar.gz
Size 448.2 kB
Tags Source
SHA-256 checksum
How to use checksums
dcbba350465ed83ef28a3bd5137cf01043f5565ab816d224fee2d4baf6974a5c
BLAKE2b-256 checksum
How to use checksums
753b1ddfa2e594831845c2b947f82830cca278ddf0f6d6c3f7b88b91b9e66438
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.10

Release files / sweatstack-0.99.0-py3-none-any.whl

Download URL sweatstack-0.99.0-py3-none-any.whl
Size 110.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
79cb3f6d084f89120e45e146cefc974e775531fcc53ac4a33c243b352ea71d47
BLAKE2b-256 checksum
How to use checksums
b75e9ad9808fdf8f86944b8ac01e12e01633e1b1e05025835868bb6f74be696f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.10

Security for sweatstack 0.99.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.99.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page