Python SDK

pip install singularity-grid
# OpenAI compatibility helper:
pip install "singularity-grid[openai]"

from singularity_grid import GridClient

grid = GridClient()                       # public endpoints — no auth
cap = grid.capacity()
print(f"Active nodes: {cap.active_nodes}/{cap.total_nodes}")
for m in grid.models():
    print(f"  {m.id} — {m.sgl_node_count} nodes")

grid = GridClient(api_key="scg_your_api_key", timeout=30.0)

from singularity_grid import GridClient

grid = GridClient(api_key="scg_your_api_key")

job = grid.submit_job(
    model="<model-id>",
    input_payload={"messages": [{"role": "user", "content": "Analyze this data"}]},
    submitter_wallet="<your-wallet>",
    submitter_chain="base",          # or "solana"
)

result = grid.get_job(job.job_id)
attestation = grid.get_attestation(job.job_id)
print(f"TEE verified: {attestation.verified}, type: {attestation.tee_type}")

# Direct
from openai import OpenAI
client = OpenAI(base_url="https://grid.x402compute.cc/v1", api_key="scg_your_api_key")

# Or via the bundled helper (no need to copy the URL)
from singularity_grid import create_openai_client
client = create_openai_client(api_key="scg_your_api_key")

resp = client.chat.completions.create(
    model="<model-id>",
    messages=[{"role": "user", "content": "Hello from the grid"}],
)
print(resp.choices[0].message.content)

from singularity_grid import GridClient

grid = GridClient(api_key="scg_your_api_key")

# Just the vectors
vecs = grid.embed("nomic-embed-text-v1.5", ["hello world", "bonjour"])
print(len(vecs), len(vecs[0]))          # 2 768

# Matryoshka: shorter vectors to save storage
short = grid.embed("nomic-embed-text-v1.5", "cat", dimensions=256)

# Full OpenAI-style response (usage, indices)
resp = grid.embeddings("bge-small-en-v1.5", ["a", "b"])
print(resp["usage"])

from singularity_grid import GridClient, SGLAuthError, SGLNotFoundError

try:
    grid.get_job("nonexistent")
except SGLNotFoundError:
    ...
except SGLAuthError:
    ...