SDKs Overview

Official SDKs for JavaScript, Python, and CLI

SDKs

PolarGrid provides official SDKs to make integration easy.

JavaScript

For Node.js and browser applications

Python

Async and sync clients with full type hints

CLI

Command-line interface for scripting and CI/CD

Installation

JavaScript

npm install @polargrid/polargrid-sdk

pip install polargrid-sdk

npm install -g @polargrid/cli

Features

All SDKs include:

Feature	JS	Python	CLI
Chat completions	✅	✅	✅
Text completions	✅	✅	—
Streaming	✅	✅	—
Text-to-Speech	✅	✅	—
Speech-to-Text	✅	✅	—
Model management	✅	✅	—
GPU management	✅	✅	—
Auto-routing	✅	✅	✅
Mock mode	✅	✅	—
Full TypeScript/Pydantic types	✅	✅	—
Async	✅	✅	—
Sync	—	✅	✅

Quick Example

JavaScript

import { PolarGrid } from '@polargrid/polargrid-sdk';

// Auto-select best region
const client = await PolarGrid.create({
  apiKey: process.env.POLARGRID_API_KEY,
});

const response = await client.chatCompletion({
  model: 'qwen-3.5-27b',
  messages: [{ role: 'user', content: 'Hello!' }],
});

console.log(response.choices[0].message.content);

import os
from polargrid import PolarGrid

# Auto-select best region
client = await PolarGrid.create(api_key=os.environ["POLARGRID_API_KEY"])

response = await client.chat_completion({
    "model": "qwen-3.5-27b",
    "messages": [{"role": "user", "content": "Hello!"}],
})

print(response.choices[0].message.content)

export POLARGRID_API_KEY="pg_your_key"
polargrid test inference --region toronto --prompt "Hello!"

Authentication

All SDKs support these authentication methods:

1. Constructor parameter: Pass apiKey / api_key directly
2. Environment variable: Set POLARGRID_API_KEY

export POLARGRID_API_KEY="pg_your_api_key"

Get your API key from the Console.