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

# SDKs

> Official itellicoAI SDKs for building voice AI applications

export const Screenshot = ({lightSrc, darkSrc, alt, caption, maxWidth = "880px"}) => {
  return <div style={{
    margin: "1rem auto",
    maxWidth,
    width: "100%"
  }}>
      <Frame>
        <img className="block dark:hidden" src={lightSrc} alt={alt} />
        <img className="hidden dark:block" src={darkSrc} alt={alt} />
      </Frame>
      {caption ? <p style={{
    marginTop: "0.5rem",
    fontSize: "0.875rem",
    color: "inherit",
    opacity: 0.8
  }}>
          {caption}
        </p> : null}
    </div>;
};

## Server SDKs

Build backend integrations with type-safe SDKs.

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/api-reference/python-sdk">
    Use a type-safe Python library with async support
  </Card>

  <Card title="TypeScript" icon="js" href="/api-reference/typescript-sdk">
    Build with full TypeScript support and autocomplete
  </Card>
</CardGroup>

***

## Getting Your API Key

Before using the SDKs, you will need an API key from your itellicoAI dashboard.

<Steps>
  <Step title="Navigate to API Keys">
    Go to your [itellicoAI dashboard](https://app.itellico.ai) and navigate to **Developers → API Keys**.
  </Step>

  <Step title="Create your key">
    Click the **Create API Key** button.

    <Screenshot lightSrc="/images/accounts__api-keys-light.png" darkSrc="/images/accounts__api-keys-dark.png" alt="API Keys management page" />
  </Step>

  <Step title="Copy and use with your SDK">
    Copy the generated API key and store it securely. The key is only shown once.
  </Step>
</Steps>

<Warning>
  Never share your API key or commit it to version control. Use environment variables to store your key securely.
</Warning>

***

## Why Use SDKs?

<CardGroup cols={2}>
  <Card title="Type Safety" icon="shield-check">
    Access full TypeScript definitions and Python type hints for all API methods
  </Card>

  <Card title="Simplified Auth" icon="key">
    Manage API keys automatically — no manual headers needed
  </Card>

  <Card title="Better Errors" icon="triangle-exclamation">
    Get structured exceptions for easier debugging
  </Card>

  <Card title="Less Code" icon="code">
    Use clean methods instead of manual HTTP requests
  </Card>
</CardGroup>

***

## Where To Find Examples

This page helps you choose an SDK and find the right reference. Language-specific pages own the runnable examples.

| If you use... | Go to                                             | What it covers                                                                    |
| ------------- | ------------------------------------------------- | --------------------------------------------------------------------------------- |
| Python        | [Python SDK](/api-reference/python-sdk)           | Installation, sync and async usage, operations, errors, and environment variables |
| TypeScript    | [TypeScript SDK](/api-reference/typescript-sdk)   | Installation, typed usage, operations, errors, and environment variables          |
| Raw HTTP      | [REST API Reference](/api-reference/introduction) | Authentication, endpoints, OpenAPI, and direct API usage                          |

***

## Installation

<Tabs>
  <Tab title="Python">
    ```bash theme={null}
    pip install itellicoai
    ```

    [View Python SDK docs →](/api-reference/python-sdk)
  </Tab>

  <Tab title="TypeScript">
    ```bash theme={null}
    npm install itellicoai
    ```

    [View TypeScript SDK docs →](/api-reference/typescript-sdk)
  </Tab>
</Tabs>

***

## Resources

<CardGroup cols={2}>
  <Card title="NPM Package" icon="js" href="https://www.npmjs.com/package/itellicoai">
    Install TypeScript SDK from NPM
  </Card>

  <Card title="PyPI Package" icon="python" href="https://pypi.org/project/itellicoai/">
    Install Python SDK from PyPI
  </Card>

  <Card title="TypeScript SDK" icon="github" href="https://github.com/itellicoAI/server-sdk-typescript">
    View TypeScript SDK source code
  </Card>

  <Card title="Python SDK" icon="github" href="https://github.com/itellicoAI/server-sdk-python">
    View Python SDK source code
  </Card>

  <Card title="REST API Reference" icon="book" href="/api-reference/introduction">
    Browse the complete REST API documentation
  </Card>

  <Card title="OpenAPI Spec" icon="file-code" href="https://api.itellico.ai/v1/openapi.json">
    View the OpenAPI specification file
  </Card>
</CardGroup>