Autumn

Autumn turns a single request into finished, sourced data. Give it a goal and it plans, searches the web, scrapes pages, cross-checks facts, and returns clean output rows with the sources behind every value. One API call does the work of a whole research and enrichment pipeline, and it keeps running in the cloud while you do something else. Every task gets a durable task_id, its own sandbox and agent, task-local files, streamed events, and output rows you can fetch any time. Start a task, walk away, and come back to results. When you need changes, continue the same task instead of starting over. Use the SDK for the fastest start, the Task API for raw HTTP, or the Skill to give another agent the same task surface.

Quick start

from autumn_sdk import AutumnClient

client = AutumnClient()
result = client.run("Find 20 AI infrastructure startups hiring founding engineers")
print(result.output)

import { AutumnClient } from "autumn-sdk";

const client = new AutumnClient();
const result = await client.run("Find 20 AI infrastructure startups hiring founding engineers");
console.log(result.output);

curl -sS -X POST "https://api.autumn.ai/task" \
  -H "X-API-Key: YOUR_AUTUMN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Find 20 AI infrastructure startups hiring founding engineers", "clarify": false}'

The response includes a task_id. Keep it. Use it to stream events, continue the task, read status, and fetch output.

The model

Autumn exposes one public primitive: a task.

prompt or task spec
        ↓
task.json plan
        ↓
sandbox + agent
        ↓
events, files, output rows

clarify is the only planning knob:

clarify: false

Default for SDK and API. The agent plans, infers defaults, and executes without stopping to ask.

clarify: true

Lets the agent ask one blocking planning question before execution.

When to use Autumn

Reach for Autumn when the work is too big or too slow for a single chat turn and you want it done end to end:

finding or enriching companies, people, jobs, filings, pages, or contacts
collecting rows with sources and evidence
scraping or checking multiple public sources
continuing a previous task without starting over
producing output files or task-local artifacts

Avoid Autumn for quick questions your agent can answer directly.

API key

Create an API key in Autumn settings under API. Pass it as either header:

X-API-Key: YOUR_AUTUMN_API_KEY

Authorization: Bearer YOUR_AUTUMN_API_KEY

The SDKs read the AUTUMN_API_KEY environment variable automatically. Use the full key you copied when creating it. The shortened key shown later in settings is only for display.

Quickstart

Install the SDK and run your first task.

Task API

HTTP routes for starting, streaming, continuing, and reading tasks.

Skill

Install the Autumn skill in Claude Code or any agent that reads skills.

Vibecoding

Drop Autumn into your coding agent with one link.

Get started

Guides

SDK

Skill

Task API

Quick start

The model

clarify: false

clarify: true

When to use Autumn

API key

Next

Quickstart

Task API

Skill

Vibecoding

​Quick start

​The model

clarify: false

clarify: true

​When to use Autumn

​API key

​Next

Quickstart

Task API

Skill

Vibecoding

Quick start

The model

When to use Autumn

API key

Next