> ## Documentation Index
> Fetch the complete documentation index at: https://platform.autumn.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Autumn

> Intelligence agents for the public web. Hand off a goal, get back finished, sourced data.

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](/docs/quickstart) for the fastest start, the [Task API](/docs/api-routes)
for raw HTTP, or the [Skill](/docs/skill) to give another agent the same task surface.

## Quick start

<CodeGroup>
  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  from autumn_sdk import AutumnClient

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

  ```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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);
  ```

  ```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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}'
  ```
</CodeGroup>

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**.

```txt theme={"theme":{"light":"github-light","dark":"github-dark"}}
prompt or task spec
        ↓
task.json plan
        ↓
sandbox + agent
        ↓
events, files, output rows
```

`clarify` is the only planning knob:

<CardGroup cols={2}>
  <Card title="clarify: false" icon="zap">
    Default for SDK and API. The agent plans, infers defaults, and executes without stopping to ask.
  </Card>

  <Card title="clarify: true" icon="circle-help">
    Lets the agent ask one blocking planning question before execution.
  </Card>
</CardGroup>

## 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:

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
X-API-Key: YOUR_AUTUMN_API_KEY
```

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
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.

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/docs/quickstart">
    Install the SDK and run your first task.
  </Card>

  <Card title="Task API" icon="terminal" href="/docs/api-routes">
    HTTP routes for starting, streaming, continuing, and reading tasks.
  </Card>

  <Card title="Skill" icon="plug" href="/docs/skill">
    Install the Autumn skill in Claude Code or any agent that reads skills.
  </Card>

  <Card title="Vibecoding" icon="sparkles" href="/docs/vibecoding">
    Drop Autumn into your coding agent with one link.
  </Card>
</CardGroup>