inis.run
Integrations

TypeScript SDK

npm client for Node, Next.js, and browser-side agent apps.

Status: Shipped — npm install inis.

Install

npm install inis
# or: pnpm add inis / bun add inis

Quick example

import { Client } from "inis";

const client = new Client({ token: process.env.INIS_API_KEY! });

const session = await client.sessions.create();
try {
  const result = await session.exec(["bash", "-c", "echo hello"]);
  console.log(result.stdout);

  await session.files.write("/workspace/script.py", "print('hello')");
  await session.exec(["python3", "/workspace/script.py"]);

  const { previewUrl } = await session.expose(8080);
  console.log(previewUrl);
} finally {
  await session.destroy();
}

API surface

Mirrors the Python SDK: sessions, exec, files, expose, pause/resume, fork, and stateless execute.

const client = new Client({
  token: process.env.INIS_API_KEY,
  baseUrl: "https://api.inis.run",
});

Types are exported for all request/response shapes. Works in Node 18+; no browser bundle (API keys must not ship to clients).

On this page