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.typedmarker
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
- Issues: GitHub Issues
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.