Authorization: Bearer gs_live_your_api_key_here

# Install (private beta — the same wheel provides the `gridshare` CLI) pip install https://gridshare.in/dl/gridshare-0.2.2-py3-none-any.whl

import gridshare # Auth (or set the GRIDSHARE_TOKEN env var and skip this) gridshare.configure(api_key="gs_live_...") # — Instances — inst = gridshare.launch(template="pytorch", gpu_vram=24) gridshare.list_instances() gridshare.get_instance(inst.id) gridshare.get_metrics(inst.id) gridshare.stop(inst.id) # — GPUs — gridshare.list_gpus(min_vram=24) gridshare.list_templates() # — Serverless (scale-to-zero endpoints) — gridshare.serverless.create(name="my-llama-3", image="gridshare/vllm:latest", env={"HF_MODEL": "meta-llama/Meta-Llama-3-8B"}) result = gridshare.serverless.run("my-llama-3", {"messages": [{"role": "user", "content": "Hello"}]}) # — Workspaces / agents whose saved files survive their machine dying — ws = gridshare.workspaces.run_agent(image="python:3.11-slim", start_command="python3 /workspace/agent.py") # — Secrets (encrypted env vars injected at boot) — gridshare.secrets.set("HF_TOKEN", "hf_abc123...") gridshare.secrets.list() # — SSH keys — gridshare.ssh_keys.add(label="MacBook", public_key="ssh-ed25519 AAAA...") # — Wallet — gridshare.balance()

# Install (private beta — installs the `gridshare` CLI and the Python SDK) pip install https://gridshare.in/dl/gridshare-0.2.2-py3-none-any.whl gridshare --help

# Auth gridshare signup # create an account gridshare login # saves to ~/.gridshare/config.json gridshare logout # Browse available GPUs gridshare gpus # available nodes (--min-vram, --city) gridshare templates # pre-built Docker templates # Instances gridshare launch # launch a GPU instance gridshare list # your instances gridshare status <id> gridshare stop <id> gridshare ssh <id> # interactive SSH session gridshare metrics <id> # live GPU metrics # Wallet & account gridshare balance gridshare topup # dev/mock mode only gridshare student-verify # institutional email → student rate gridshare referral info # ₹100 each when a friend's first top-up is ₹500+

# Request body { "image": "gridshare/jupyter:latest", # required — any template image or your own "label": "my-notebook", # optional: friendly name in the dashboard "gpu_count": 1, # 0-8 (0 = CPU-only) "min_vram_gb": 8, # optional: minimum GPU VRAM "disk_gb": 20, # workspace disk, 5-500 GB "exposed_ports": [8888, 7860], # ports proxied over HTTPS "env": {"MY_VAR": "value"}, # optional: additional env vars "use_secrets": true, # inject saved secrets at /run/gs_secrets/env "ssh_pubkey": "ssh-rsa AAAA..." # optional: passwordless SSH }

# Response example { "id": "57f993b4-c2e9-432e-99c2-2c02f076344a", "status": "running", # provisioning|starting|running|stopped|error "image": "gridshare/jupyter:latest", "gpu_count": 1, "rate_per_hr_inr": 12.0, "total_cost_inr": 2.25, # total so far "ssh": { "host": "relay.gridshare.in", "port": 30042, "user": "root", "command": "ssh -p 30042 root@relay.gridshare.in" }, # null fields + "native_mac":true on Apple-silicon machines (no SSH — use the web apps) "port_map": {"8888": "https://relay.gridshare.in/proxy/57f993b4-.../8888/"}, "created_at": "2026-08-28T17:44:00Z" }

{"label": "MacBook Pro", "public_key": "ssh-ed25519 AAAA..."}

{"name": "HF_TOKEN", "value": "hf_aBcDe12345..."} # Name must be valid env var (A-Z, 0-9, underscore)

# With the SDK (the CLI has no --use-secrets flag yet) gridshare.launch(template="pytorch", gpu_vram=24, use_secrets=True) # With API {"image": "gridshare/pytorch:latest", "use_secrets": true}

# Shell — load all secrets into the current session source /run/gs_secrets/env # Python — parse the file directly secrets = dict( line.split("=", 1) for line in open("/run/gs_secrets/env").read().splitlines() if line and not line.startswith("#") ) hf_token = secrets["HF_TOKEN"]

{ "name": "my-llama-3-8b", "image": "gridshare/vllm:latest", "min_workers": 0, # 0 = scale to zero "max_workers": 5, "use_secrets": true # inject saved secrets at /run/gs_secrets/env }

{"prompt": "Explain transformers in Hindi", "max_tokens": 512} # Response: {"output": "...", "compute_ms": 2100, "cost_inr": 0.026}

{ "url": "https://myserver.com/gridshare-hook", "label": "production", "events": ["instance.started", "instance.completed", "instance.migrated"] // omit "events" entirely to receive every event }

# Verify webhook signature (Python) import hashlib, hmac def verify_signature(secret: str, body: bytes, sig_header: str) -> bool: expected = "sha256=" + hmac.new( secret.encode(), body, hashlib.sha256 ).hexdigest() return hmac.compare_digest(expected, sig_header) # X-GridShare-Signature header contains: "sha256=<hex>"

{"alert_threshold_inr": 200} # When balance < ₹200, you get alerted. Set to 0 to disable.

# Launch Jupyter instance gridshare launch --template jupyter --gpu-vram 16 # Get its URL (open it from the dashboard, or read it off status) gridshare status <id> # OR: open the machine's card at https://gridshare.in/app — the Jupyter # button opens https://relay.gridshare.in/proxy/<instance-id>/8888/