airmy.dev / developers / sdk-libraries
/ SDK Libraries
Official SDKs
AIRMY-maintained client libraries for the most common runtimes. All SDKs are open-source and available on GitHub.
Py
Python SDK
Python 3.9+
pip install airmy
from airmy import Airmy
client = Airmy(api_key="sk-airmy-...")
run = client.runs.create(
agent_id="ag_01HXYZ",
input={"query": "Summarise Q1 financials"}
)
print(run.output)Async support (asyncio)Streaming responsesAuto-retry with backoffFull type annotations
TS
TypeScript / Node.js SDK
Node 18+ · Browser
npm install @airmy/sdk
import Airmy from '@airmy/sdk';
const client = new Airmy({ apiKey: process.env.AIRMY_API_KEY });
const run = await client.runs.create({
agentId: 'ag_01HXYZ',
input: { query: 'Summarise Q1 financials' }
});
console.log(run.output);Full TypeScript typesESM + CJSFetch-based (no deps)Browser compatible
Go
Go SDK
Go 1.21+
go get github.com/airmy/airmy-go
client := airmy.NewClient(os.Getenv("AIRMY_API_KEY"))
run, err := client.Runs.Create(ctx, &airmy.RunParams{
AgentID: "ag_01HXYZ",
Input: map[string]any{"query": "Summarise Q1 financials"},
})
if err != nil {
log.Fatal(err)
}
fmt.Println(run.Output)Context supportIdiomatic error handlingMinimal dependencies
Versioning & Stability
SDK versions track API versions. Pin to a major version for stability. We follow semantic versioning.