Skip to main content

yousleep-common

The youSleep Portal for Python: a typed, asynchronous client for the REST API, the models every request and response is made of, and the tools an analysis container uses to read its manifest and write its result.

pip install yousleep-common
from yousleep_common.client import AsyncClient
from yousleep_common.models import UserAuthentication

client = await AsyncClient.from_credentials(
    base_url="https://api.yousleep.ai",
    # The email and password you sign in to the portal with.
    credentials=UserAuthentication(email="you@example.com", password="…"),
)
async with client:
    result = await client.workflows.analyze_file(
        file="night.edf", analysis_config_id="u-sleep-research-v2"
    )
    print(result.biomarkers.biomarkers.tst_min, len(result.events))

One call uploads the recording, submits the analysis, waits for it and returns the events and statistics it produced. analyze_files does the same for a batch, one outcome per file; the namespaced endpoints (client.projects, client.analyses, …) are the same operations one level down.

Documentation: docs.yousleep.ai carries the SDK guides, the generated API reference, and how to package an analysis to run on the platform. The installed package resolves every signature offline, so help() and an IDE work without it.

Command line. yousleep-init starts an analysis project that passes the conformance check as generated, yousleep-verify runs that check on an image (and with --meter measures its memory against recording length), and yousleep-manifest writes the manifest a container reads for a hand run.

Python 3.11 or later. Every GitHub release also attaches the wheel as an asset, the copy to install from when PyPI's index has not caught up.

Research use. youSleep is for research and other non-commercial use; nothing here is a medical device.

Licensed under Apache-2.0. Contact: contact@yousleep.ai.

Metadata

Release files for yousleep-common 46.1.0

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

Built distribution (wheel)

Table of built distributions (wheels) for yousleep-common 46.1.0
File Interpreter ABI Platform
yousleep_common-46.1.0-py3-none-any.whl Python 3 none any Details

Release files / yousleep_common-46.1.0-py3-none-any.whl

Download URL yousleep_common-46.1.0-py3-none-any.whl
Size 415.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6dec65dfea5fcbde6c833203d7297f5d7c9071d5e024add003068a6482ca5406
BLAKE2b-256 checksum
How to use checksums
009a3cd2715b2466e14f1a709932f4efa7e0ed31d59ec931c121619049c3dfc6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for yousleep-common 46.1.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.

Full provenance

All 1 file in this release has been uploaded with provenance metadata.

Attestation for yousleep_common-46.1.0-py3-none-any.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

46.1.0 This release

1 release file Full 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