TypeScript SDK

npm install autumn-sdk
npm install zod@4   # for schema (structured output)

export AUTUMN_API_KEY=your_key

import { AutumnClient } from "autumn-sdk";

const client = new AutumnClient();                          // reads AUTUMN_API_KEY
const client2 = new AutumnClient({ apiKey: "...", baseUrl: "https://api.autumn.ai" });

const result = await client.run("Find the top story on Hacker News");
console.log(result.output);

const run = client.run("Find the top story on Hacker News");
for await (const msg of run) console.log(`[${msg.type}] ${msg.summary}`);
console.log(run.result?.output);

import { AutumnClient } from "autumn-sdk";

const client = new AutumnClient();

const attached = await client.files.upload("leads.csv");
const result = await client.run("Enrich every row with the company domain", {
  task_id: attached.task_id,
  input_files: [attached.filename],
});

import { OutOfCreditsError, TaskExecutingError, AuthenticationError } from "autumn-sdk";