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

# Quickstart

> Go from zero to your first agent response in a few minutes

The fastest way to build on Cominty is the **Python SDK** — an async, fully-typed
client for the chat API. This guide takes you from install to your first
streamed agent response.

<Note>
  Prefer raw HTTP? Every call the SDK makes is a standard HTTPS/JSON request
  against `https://ds.cominty.com`. Browse them in the
  [API reference](/api-reference), each with a live playground.
</Note>

## Get started

<Steps>
  <Step title="Install the SDK">
    ```bash theme={null}
    pip install cominty-sdk        # or: uv add cominty-sdk
    ```

    Requires Python 3.9+.
  </Step>

  <Step title="Get your credentials">
    From [platform.cominty.ai](https://platform.cominty.ai), grab two things:

    * **API key** — from the **API keys** page.
    * **User id** — from your avatar → **Profile** (looks like
      `user_31HPTBuBvX20xlQNAbvxjOxPbKB`).

    Export both so the client picks them up automatically. Treat the API key
    like a password.

    ```bash theme={null}
    export COMINTY_API_KEY="<your API key>"
    export COMINTY_USER_ID="user_..."
    ```
  </Step>

  <Step title="Send your first message">
    Pick an `agent_id` from
    [platform.cominty.ai/agents](https://platform.cominty.ai/agents) and ask it
    something.

    ```python theme={null}
    import asyncio
    from cominty_sdk import AsyncCominty

    async def main():
        async with AsyncCominty() as client:      # reads COMINTY_API_KEY + COMINTY_USER_ID
            run = await client.chat.start(
                agent_id="__cominty_agents::agent.chat",
                message="What is Cominty?",
            )
            print(await run.text())               # blocks until the agent finishes

    asyncio.run(main())
    ```

    Printed a response? You're ready to build.
  </Step>
</Steps>

<Tip>
  Next, stream the agent's progress, continue the conversation, and handle
  errors — see the [SDK quickstart](/sdk/quickstart) for runnable examples, and
  the [SDK reference](/sdk/reference) for the full surface.
</Tip>

Need help? Reach out at [hi@cominty.com](mailto:hi@cominty.com).