Graviton Python SDK

The Graviton SDK provides a seamless way to connect your local mathematical models (built with SymPy) to the Graviton Supercompute platform.

Installation

pip install graviton-sdk

Quick Start (Jupyter/Colab)

The SDK is designed to work beautifully in interactive environments.

import sympy as sp
import graviton as gv

# 1. Authenticate (Use the public evaluation key for prototyping)
gv.login('a-little-more-art-than-science')

# 2. Define a complex model
x, y = sp.symbols('x y')
f = sp.sin(x)**2 + sp.exp(-y) * sp.cos(x)

# 3. Display with the Graviton "Compute" button
gv.expr(f)

Programmatic Workflow

For advanced integrations, you can use the flattened API to evaluate and compute programmatically.

# 1. Evaluate to get JSON data
eval_data = gv.evaluate(f, options={"type": "JSON"})

# 2. Use flattened access for cost and ID
cost = eval_data['cost']
job_id = eval_data['id']

print(f"Estimated Cost: {cost:.2f} credits")

# 3. Compute using the ID directly
job = gv.compute(job_id, options={"auto_charge": True})
result = job.wait()
print(f"Result: {result}")

How it Works

When you call gv(formula), the SDK:

Serializes the SymPy object into a structured srepr format.
Generates a rich HTML representation with a LaTeX preview.
Adds a secure button that opens the Graviton Dashboard with your formula pre-loaded.

This allows you to leverage Graviton's massive cloud compute resources for complexity analysis and evaluation without ever leaving your research environment.

Security

Graviton follows a "Data, not Code" security model. The SDK only transmits the mathematical structure of your model, not arbitrary Python code. Your local environment remains isolated, and all authentication is handled securely via the Graviton web platform.

Metadata

Release files for graviton-sdk 0.1.7

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

Source distribution (sdist)

Source distribution for graviton-sdk 0.1.7
File	Size	Uploaded	Provenance
graviton_sdk-0.1.7.tar.gz	8.7 kB	Aug 19, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for graviton-sdk 0.1.7
File	Interpreter	ABI	Platform	Reset
graviton_sdk-0.1.7-py3-none-any.whl 9.7 kB Aug 19, 2026 With provenance	Python 3	none	any	Details

Total release size: 18.4 kB

Release files / graviton_sdk-0.1.7.tar.gz

Download URL	graviton_sdk-0.1.7.tar.gz
Size	8.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`14dbf42255abadc8f13ff02b1fd7968291bc2d8e605ea0b52cca79a45d7fb5fd`
BLAKE2b-256 checksum How to use checksums	`ee6f8d556be839910fc13338cc31f68f76f6a3401730ff2ad0339be87996fb50`
Upload date	Aug 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CodeZeroLabs/graviton
Publishing commit: github.com/CodeZeroLabs/graviton/tree/cc79dceba87f6fbd4a71dfe55372cb14cae05868

Workflow

Publishing configuration: github.com/CodeZeroLabs/graviton/blob/cc79dceba87f6fbd4a71dfe55372cb14cae05868/.github/workflows/deploy.yml
Publishing logs: github.com/CodeZeroLabs/graviton/actions/runs/32226381674/attempts/1

Artifact

Subject: graviton_sdk-0.1.7.tar.gz
SHA-256 checksum: 14dbf42255abadc8f13ff02b1fd7968291bc2d8e605ea0b52cca79a45d7fb5fd Verifying attestations

Release files / graviton_sdk-0.1.7-py3-none-any.whl

Download URL	graviton_sdk-0.1.7-py3-none-any.whl
Size	9.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b7ffa18aecbf1692094f0844b5d346841bbf216cc46b906e73b6d4fa20a5ad8b`
BLAKE2b-256 checksum How to use checksums	`4ffc6c94b0c0a89425f418af8a52ba01f4d76b90c807c5dbd970fcff1583c368`
Upload date	Aug 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CodeZeroLabs/graviton
Publishing commit: github.com/CodeZeroLabs/graviton/tree/cc79dceba87f6fbd4a71dfe55372cb14cae05868

Workflow

Publishing configuration: github.com/CodeZeroLabs/graviton/blob/cc79dceba87f6fbd4a71dfe55372cb14cae05868/.github/workflows/deploy.yml
Publishing logs: github.com/CodeZeroLabs/graviton/actions/runs/32226381674/attempts/1

Artifact

Subject: graviton_sdk-0.1.7-py3-none-any.whl
SHA-256 checksum: b7ffa18aecbf1692094f0844b5d346841bbf216cc46b906e73b6d4fa20a5ad8b Verifying attestations

Security for graviton-sdk 0.1.7

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for graviton_sdk-0.1.7.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/CodeZeroLabs/graviton
Publishing commit: github.com/CodeZeroLabs/graviton/tree/cc79dceba87f6fbd4a71dfe55372cb14cae05868

Workflow

Publishing configuration: github.com/CodeZeroLabs/graviton/blob/cc79dceba87f6fbd4a71dfe55372cb14cae05868/.github/workflows/deploy.yml
Publishing logs: github.com/CodeZeroLabs/graviton/actions/runs/32226381674/attempts/1

Artifact

Subject: graviton_sdk-0.1.7.tar.gz
SHA-256 checksum: 14dbf42255abadc8f13ff02b1fd7968291bc2d8e605ea0b52cca79a45d7fb5fd Verifying attestations

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.