Lightning-AI/sdk v2026.07.03

Lightning SDK 2026.07.03

Repository: Lightning-AI/sdk

Tag: v2026.07.03

Published: 2026-07-03T19:12:58Z

Prerelease: no

Release notes: This is the first initial release of the Lightning SDK since open-sourcing the repository. It establishes the public home for the SDK across Python, CLI, TypeScript, and Go.

Python SDK

The Python SDK provides the high-level interface for working with Lightning AI resources from Python applications and automation scripts.

from lightning_sdk import Studio, Machine

studio = Studio("sdk-demo", teamspace="owner/teamspace", create_ok=True)
studio.start(Machine.CPU)
print(studio.run("python --version"))
studio.stop()

Command Line Interface

The CLI supports terminal-first workflows, shell scripts, and CI jobs for managing Lightning resources.

lightning studio start --name sdk-demo --teamspace owner/teamspace --machine CPU

lightning job run \
--name train-job \
--teamspace owner/teamspace \
--studio sdk-demo \
--command "python train.py"

Raw API Access

Raw API access gives users an authenticated escape hatch for endpoints that do not yet have dedicated SDK or CLI commands.

PROJECT_ID="$(lightning-sdk api /v1/memberships | jq -r '.memberships[0].projectId')"

lightning-sdk api "/v1/projects/${PROJECT_ID}/jobs" -X GET -F limit=20

TypeScript SDK

The TypeScript SDK focuses on Lightning AI sandboxes for Node.js automation, including command execution, file operations, PTY sessions, snapshots, and persistent sandbox workflows.

import { Sandbox } from "@lightningai/sdk";

const sandbox = await Sandbox.create({
name: "typescript-demo",
instanceType: "cpu-1",
});

const result = await sandbox.runCommand("echo", ["hello from Lightning"]);
console.log(result.output);

await sandbox.delete();

Go SDK

The Go SDK exposes Lightning resources as typed handles for backend services, infrastructure tooling, and strongly typed automation.

package main

import (
"fmt"
"log"

lit "github.com/lightning-ai/sdk/go"
)

func main() {
org, err := lit.GetOrganization("my-org")
if err != nil {
log.Fatal(err)
}

teamspace, err := lit.GetTeamspace("my-teamspace", lit.TeamspaceOptions{Owner: org})
if err != nil {
log.Fatal(err)
}

job, err := lit.RunJob(
"go-demo-job",
lit.MachineCPU,
"python -c 'print(\"hello from Lightning\")'",
lit.JobOptions{
Teamspace: teamspace,
Image: "python:3.11-slim",
},
)
if err != nil {
log.Fatal(err)
}

if err := job.Wait(); err != nil {
log.Fatal(err)
}

fmt.Println(job.Status())
}