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

res = grid.chat_completions(
    model="qwen2.5-vl-3b",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What is in this image?"},
                {"type": "image_url", "image_url": {"url": "data:image/png;base64,iVBORw0KGgo..."}},
            ],
        }
    ],
    max_tokens=256,
)
print(res["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:
    ...