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.101.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.101.0
File Size Uploaded Provenance Actions
sweatstack-0.101.0.tar.gz 462.0 kB Without provenance Details for sweatstack-0.101.0.tar.gz

Built distribution (wheel)

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

Total release size: 574.8 kB

Release files / sweatstack-0.101.0.tar.gz

Download URL sweatstack-0.101.0.tar.gz
Size 462.0 kB
Tags Source
SHA-256 checksum
How to use checksums
29c745f0fa52a79f8b2eb03ae73c2ada06f9696226a559ffb4957782562425df
BLAKE2b-256 checksum
How to use checksums
4fcd6f2fa5e935cca370cf0153a1fb7a6ead852b051c92286cca2b37990bcdbc
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.101.0-py3-none-any.whl

Download URL sweatstack-0.101.0-py3-none-any.whl
Size 112.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
93232269d06b3fca5984e2e8b795dd5a02ae6d1d068ac11a9479c5e0eb47d259
BLAKE2b-256 checksum
How to use checksums
e907a4ada0860a0e0a1f8e130f863c365c37028f74f60401a4c0608ccd320c49
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.101.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.101.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