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
- Python SDK guide: authentication, clients, data output, errors, Streamlit and FastAPI
- API reference: every endpoint and model
- Changelog
- Upgrading: moving from an older release, from any version, with a prompt for your coding agent. Also at docs.sweatstack.no.
Sports follow OpenSportTaxonomy: sweatstack.Sport
is its Sport type.
1 maintainer
Metadata
1 maintainer
Release files for sweatstack 0.96.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sweatstack-0.96.0.tar.gz | 462.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sweatstack-0.96.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 568.9 kB
Release files / sweatstack-0.96.0.tar.gz
| Download URL | sweatstack-0.96.0.tar.gz |
|---|---|
| Size | 462.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f05a03f1ce9498f70d8eb3575a8b4eecbc3df756d4c45c288fd3db1fdc13bce2
|
|
BLAKE2b-256 checksum How to use checksums |
93347a83632866e54ae2f93e0f3a1fa60ac559c8ec34346c52d88677046ec5b9
|
| 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.96.0-py3-none-any.whl
| Download URL | sweatstack-0.96.0-py3-none-any.whl |
|---|---|
| Size | 106.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3066946aaeeab06b520aa0b959033ca7a40da08cb19c42a788ac55849afa5270
|
|
BLAKE2b-256 checksum How to use checksums |
b93937f97146d84d42f25b67f00c728c7f21f6b235eeab5e96c6ae49556ceb55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.10
|
