SDKs & Programmatic Clients
Integrate Helix specialists into backend automation, internal CLI tooling, Python pipelines, or customer-facing SaaS products.
1. TypeScript / JavaScript SDK (@launchverse/helix-sdk)
Install the unified client library used internally across Web, Windows Desktop, and Android:
npm install @launchverse/helix-sdkCore Methods Overview
import { HelixClient, buildEmbedSnippet } from "@launchverse/helix-sdk";
const helix = new HelixClient({
baseUrl: "https://launchverse.app",
apiKey: process.env.HELIX_API_KEY!,
});
// Start a background autonomous mission in a sandbox
const run = await helix.runs.startDetached({
goal: "Add Postgres index on orders(team_id, created_at) and run migration checks",
mode: "supervised",
});
// Inspect workspace threads, missions, and live runs
const [{ threads }, { missions }, { runs }] = await Promise.all([
helix.threads.list(),
helix.missions.list({ attention: false, limit: 20 }),
helix.runs.live(),
]);
// Decide an awaiting approval gate
await helix.approvals.decide("apr_01J...", {
decision: "approved",
note: "Index migration reviewed",
});
// Inspect cryptographic audit ledger
const ledger = await helix.approvals.ledger({ limit: 25 });2. Python OpenAI-Compatible Client (/api/v1)
Helix exposes OpenAI-compatible inference at /api/v1/chat/completions, working seamlessly with the official openai Python SDK or standard requests:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://launchverse.app/api/v1",
api_key=os.environ["HELIX_API_KEY"],
)
completion = client.chat.completions.create(
model="helix/operator",
messages=[
{"role": "system", "content": "Respond concisely with verified commands."},
{"role": "user", "content": "Audit CSP headers for strict third-party script blocking."},
],
)
print(completion.choices[0].message.content)For full autonomous sandbox runs (runs, threads, approvals), call /api/v2/runs directly via requests or httpx (see 5-Minute Quickstart).
3. Embeddable Web Components (<helix-staff-embed>)
Mount customer-isolated workspaces in React, Vue, Svelte, Angular, or plain HTML without writing backend proxy infrastructure:
<script src="https://launchverse.app/embed/helix-staff.js" defer></script>
<helix-staff-embed
token="hx_embed_customer_scoped_token"
surface="office"
principal-id="acct_42"
theme="dark"
white-label="true"
></helix-staff-embed>Read the full configuration, postMessage contract, and CSP guide in Drop-In White-Label Agent Embeds.

