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

# Quickstart

> Running your first task

## Setting up

Get your free API key and start running tasks in minutes.

<Card title="Get your free API key" icon="key" href="https://app.smooth.sh" horizontal>
  Unlock your free welcome credits. No credit card required.
</Card>

## Install Smooth

Smooth has both a Python and a Typescript SDK.
The Typescript SDK is automatically generate from the Python SDK and provides the same interface.

<CodeGroup>
  ```bash Python theme={null}
  pip install smooth-py
  ```

  ```bash Typescript theme={null}
  npm installl @circlemind-ai/smooth-ts
  ```
</CodeGroup>

<Note>
  To directly interface with the APIs, refer to the [API documentation](https://docs.smooth.sh/api-reference/introduction)
</Note>

## Run a task

Submit a task in seconds.

<CodeGroup>
  ```python Python theme={null}
  from smooth import SmoothClient

  smooth_client = SmoothClient(api_key="cmzr-YOUR_API_KEY")
  task = smooth_client.run("Go to google flights and find the cheapest flight from London to Paris today")

  print(f"Live URL: {task.live_url()}")
  print(f"Agent response: {task.result()}")
  ```

  ```typescript Typescript theme={null}
  import { SmoothClient } from "@circlemind-ai/smooth-ts";

  const client = new SmoothClient({
    api_key: "cmzr-YOUR_API_KEY",
  });

  const task = await client.run({
    task: "Go to google flights and find the cheapest flight from London to Paris today",
  })

  console.log("Live URL:", await task.live_url())
  console.log("Agent response:", await task.result())
  ```

  ```javascript Javascript theme={null}
  fetch('https://api.smooth.sh/api/v1/task/smooth', {
    method: 'POST',
    headers: {
      'apikey': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ 'max_steps': 32, 'task': 'your_task_description' })
  })
  ```

  ```curl cURL theme={null}
  curl -X POST https://api.smooth.sh/api/v1/task/smooth \ 
            -H "apikey: cmzr-YOUR_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{"max_steps": 32, "task": "your_task_description"}'
  ```
</CodeGroup>

## Next steps

That's all it takes to start automating with Smooth!

If you want to learn how to implement more complex workflows in Python, check out our [examples](/features/).

Or, dive deep into our API and read about the different parameters on our [API Reference](/api-reference/introduction).

<Note>
  To play around with the API, check out our [playground](https://app.smooth.sh).
</Note>