TypeScript quick start

@lighton-ai/sdk wraps the LightOn API: typed models, pagination handled for you, and rate-limit pacing built in. It’s the code shown in the TypeScript SDK tab of every tutorial snippet.

Requires Node 22 or later. Also runs on Bun, Deno, Cloudflare Workers, Vercel Edge, and in the browser, with no runtime dependencies.

Install

npm install @lighton-ai/sdk

Set your API key in the environment. new LightOn() reads it from there, so it never appears in your code:

export LIGHTON_API_KEY="..."

Your first result

import { LightOn, Workspace } from "@lighton-ai/sdk"

const client = new LightOn() // reads LIGHTON_API_KEY from the environment
const workspace = await new Workspace({ name: "Docs" }).create(client)
await workspace.ingestMany(["docs/**/*.pdf"], { wait: true })

const answer = await client.ask("What were Q4 revenues?", { workspaces: [workspace] })
console.log(answer.answer)

Where to go next

API reference

Every public class, method, and type, generated from the installed SDK.

Tutorials

Task-by-task walkthroughs, each with a TypeScript SDK tab.

For structured output with Zod, async jobs, error handling, and agent-framework integrations (Vercel AI SDK, LangChain.js), see the SDK README.

Overview

Python

TypeScript

Install

Your first result

Where to go next

API reference

Tutorials

​Install

​Your first result

​Where to go next

API reference

Tutorials

Install

Your first result

Where to go next