Skip to main content

cosmicintersection-sdk

Official Python SDK for Cosmicintersection — an open scientific data-commons on the Burdenoff platform.

Pre-launch notice: Cosmicintersection is launching in 2026. This package is published ahead of general availability so integrators can build early. There is no live production service yet — join the waitlist at cosmicintersection.com to get early access.

This SDK is a thin shell over burdenoff-sdk-libs. It mounts the shared platform modules plus the Cosmicintersection domain module and a standalone sandbox module, and exposes them as one ergonomic, fully typed client.

Features

  • Async/await throughout, built on httpx
  • Dual-endpoint GraphQL client (workspace + global gateways)
  • 23 mounted modules: the shared generic set + cosmicintersection + sandbox
  • Multiple auth flows: email/password, device code, PKCE, client credentials
  • Automatic token refresh
  • Typed error hierarchy
  • Full type hints with py.typed marker

Installation

pip install cosmicintersection-sdk

# Development install
pip install -e ".[dev]"

Quick Start

import asyncio
from cosmicintersection_sdk import CosmicintersectionSDK


async def main():
    # Defaults to the shared prod gateways and the burdenoff_cli_cosmicintersection
    # OIDC client. Override the endpoints for local dev.
    sdk = CosmicintersectionSDK()

    # Sign in with email/password
    await sdk.auth.sign_in(email="user@example.com", password="secret")

    # Cosmicintersection-domain operations are nested under sdk.cosmicintersection
    datasets = await sdk.cosmicintersection.datasets.list()
    sources = await sdk.cosmicintersection.sources.list()

    # Shared cross-product modules are mounted at the top level
    tags = await sdk.tags.list()

    await sdk.close()


asyncio.run(main())

Nested namespace

Per the platform mandate (no compatibility shim), every module surface is nested under its owning module. The Cosmicintersection domain bundle keeps its sub-entities nested:

await sdk.cosmicintersection.sources.list()
await sdk.cosmicintersection.datasets.list()
await sdk.cosmicintersection.schema_fields.list()
await sdk.cosmicintersection.collections.list()
await sdk.cosmicintersection.notebooks.list()
await sdk.cosmicintersection.analyses.list()
await sdk.cosmicintersection.pipelines.list()
await sdk.cosmicintersection.runs.list()
await sdk.cosmicintersection.steps.list()
await sdk.cosmicintersection.releases.list()
await sdk.cosmicintersection.grants.list()
await sdk.cosmicintersection.system.health()

Modules

All methods are async. The following modules are mounted on the CosmicintersectionSDK instance: auth, billing, channels, conversations, devportal, export, files, groups, health, integrations, cosmicintersection, notifications, organizations, products, rbac, sandbox, scheduler, security, store, support, tags, tours, workspaces.

Configuration

from cosmicintersection_sdk import CosmicintersectionSDK

sdk = CosmicintersectionSDK(
    workspace_endpoint="https://graphqlworkspaces.burdenoff.com/workspaces/graphql",
    global_endpoint="https://graphql.burdenoff.com/global/graphql",
    client_id="burdenoff_cli_cosmicintersection",   # default
    oidc_issuer=None,                       # derived from global_endpoint
    api_key=None,
    access_token=None,
    refresh_token=None,
    workspace_token=None,
    timeout=30.0,
    auto_refresh=True,
)

Error Handling

from cosmicintersection_sdk import (
    CosmicintersectionError,
    AuthenticationError,
    AuthorizationError,
    NetworkError,
    ValidationError,
    RateLimitError,
    DeviceCodeExpiredError,
    DeviceCodeDeniedError,
)

try:
    await sdk.auth.sign_in(email="user@example.com", password="wrong")
except AuthenticationError:
    print("Invalid credentials")
except NetworkError:
    print("Could not reach the API")
except CosmicintersectionError as e:
    print(f"SDK error: {e}")

Development

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

make format        # black + isort
make lint          # flake8
make type-check    # mypy (strict)
make test          # pytest
make sanity        # format-check + lint + type-check + test (cov>=80) + build

License

Proprietary — Copyright Algoshred Technologies Pvt. Ltd.

Support

Metadata

Release files for cosmicintersection-sdk 2026.1107.1

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

Source distribution (sdist)

Source distribution for cosmicintersection-sdk 2026.1107.1
File Size Uploaded Provenance Actions
cosmicintersection_sdk-2026.1107.1.tar.gz 15.5 kB Without provenance Details for cosmicintersection_sdk-2026.1107.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cosmicintersection-sdk 2026.1107.1
File Interpreter ABI Platform Actions
cosmicintersection_sdk-2026.1107.1-py3-none-any.whl Python 3 none any Details for cosmicintersection_sdk-2026.1107.1-py3-none-any.whl

Total release size: 24.3 kB

Release files / cosmicintersection_sdk-2026.1107.1.tar.gz

Download URL cosmicintersection_sdk-2026.1107.1.tar.gz
Size 15.5 kB
Tags Source
SHA-256 checksum
How to use checksums
9f5619581dea5ad0074e4c66febb47e58e2c620c8e149a1e647d294bb1875430
BLAKE2b-256 checksum
How to use checksums
67b113626f4855727667bfb33f7c7ffa30b355a7455c57f7f7259ac191340781
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.18

Release files / cosmicintersection_sdk-2026.1107.1-py3-none-any.whl

Download URL cosmicintersection_sdk-2026.1107.1-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
479aa45a7c32b839b445fa11fd8d6ceb3d522353d7b234c32255e823ada58e04
BLAKE2b-256 checksum
How to use checksums
d41076f9e0bf9db67555e14d74c43b2036b58b9f5790175bf8fb1fcabd9f3857
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.18

Security for cosmicintersection-sdk 2026.1107.1

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
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