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

# Getting started

> Install the client, set your API key, and run an agent

This quickstart is the fastest path to **run an agent** against **Sudoiq** and see a completed result. Use **Python** (`agentsapi`), the **`agentservice` CLI**, or (soon) **Node.js**.

## Before you begin

* Python **3.10+** if you use the Python client or install the CLI via pip.
* A virtual environment (recommended):

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
```

* A **Sudoiq account** and an **API key**: create one at [Sudoiq settings](https://sudoiq.com/settings).

Install the Python client (for the **Python** tab below):

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
pip install agentserviceapi
```

<Note>
  The Python SDK on PyPI is **`agentserviceapi`** (`pip install agentserviceapi`); import it as **`agentsapi`** in code (`from agentsapi import ...`). The CLI wheel package name is **`agentservice`**.
</Note>

## Run one agent

Use the dropdown to switch between **Python**, **Node.js**, and **CLI**. After start, the client **waits** for the run to finish using a **long-lived streaming connection** when the API supports it (server-sent events, SSE), so you do not write your own polling loop.

<CodeGroup dropdown>
  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import asyncio
  from agentsapi import AgentServiceAPIClient

  async def main():
      client = AgentServiceAPIClient()
      client.set_api_key("sk_...")  # from https://sudoiq.com/settings

      result = await client.run_agent(
          agent_id="YOUR_AGENT_UUID",
          string_inputs={"1": "Hello"},
          environment="playground",
      )
      print(result.status)
      print(result.result)

  asyncio.run(main())
  ```

  ```typescript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
  // Node.js client — coming soon.
  export {};
  ```

  ```bash CLI theme={"theme":{"light":"github-light","dark":"github-dark"}}
  pip install agentservice
  agentservice login
  agentservice config --host sudoiq.com
  agentservice execute --agent-id YOUR_AGENT_UUID --input 1="Hello" --wait
  ```
</CodeGroup>

### After your first run

Add **tools**, **validators**, and **tests** so you can measure and improve behavior:

* [Python client: add a tool](/clients/python#add-a-tool)
* [Evals, tests, and feedback](/concepts/evals-tests-and-feedback)

For alternative delivery models (for example very long-running jobs), see [Running agents](/agents/running-agents).

## Next steps

* [What is an agent?](/concepts/what-is-an-agent)
* [How runs work](/concepts/how-runs-work)
* [Python client](/clients/python)
* [CLI reference](/clients/cli)