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

# SDK

> Официальные SDK и клиентские библиотеки для Avala API

Avala предоставляет официальные SDK и клиентские библиотеки для интеграции с платформой на предпочитаемом языке или фреймворке. Каждый SDK оборачивает Avala REST API идиоматическими методами, встроенной аутентификацией, автоматическими повторными попытками и полной типобезопасностью.

## Клиентские библиотеки

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/docs/ru/sdks/python">
    Синхронная и асинхронная поддержка. Полные аннотации типов. Python 3.9+.
  </Card>

  <Card title="TypeScript" icon="js" href="/docs/ru/sdks/typescript">
    Полная типизация. Ноль зависимостей. Работает в Node.js, Deno и Bun.
  </Card>

  <Card title="CLI" icon="terminal" href="/docs/ru/sdks/cli">
    Управление наборами данных, экспортами и хранилищем из терминала. `curl -fsSL https://avala.ai/install.sh | bash`.
  </Card>

  <Card title="REST API" icon="globe" href="/docs/sdks/rest-api">
    Используйте API напрямую из любого языка через HTTP-запросы.
  </Card>

  <Card title="OpenAPI" icon="code" href="/docs/sdks/openapi">
    Сгенерируйте собственный клиент из спецификации OpenAPI.
  </Card>
</CardGroup>

## Быстрое сравнение

| Функция                    | Python                 | TypeScript                  | CLI                                              | REST API    |
| -------------------------- | ---------------------- | --------------------------- | ------------------------------------------------ | ----------- |
| **Установка**              | `pip install avala`    | `npm install @avala-ai/sdk` | `curl -fsSL https://avala.ai/install.sh \| bash` | Прямой HTTP |
| **Async**                  | Sync + Async           | Async                       | Н/Д                                              | Любой       |
| **Типобезопасность**       | Полные аннотации типов | Полные типы TypeScript      | Н/Д                                              | Н/Д         |
| **Автоматические повторы** | Да                     | Да                          | Через SDK                                        | Вручную     |
| **Пагинация**              | Встроенные итераторы   | Встроенные итераторы        | Флаг `--limit`                                   | Вручную     |
| **Зависимости**            | httpx, pydantic        | Нет (нативный fetch)        | click, rich                                      | Н/Д         |

## Переменные окружения

Все SDK учитывают следующие переменные окружения, поэтому вы можете настроить их один раз и использовать во всём стеке.

| Переменная       | Описание                                                                                                       | По умолчанию                  |
| ---------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `AVALA_API_KEY`  | Ваш API-ключ Avala для аутентификации. Используется автоматически, если ключ не передан в конструктор клиента. | Нет (обязательно)             |
| `AVALA_BASE_URL` | Переопределение базового URL API. Полезно для self-hosted развёртываний или сред разработки.                   | `https://api.avala.ai/api/v1` |

## Аутентификация

Все запросы к Avala API должны включать ваш API-ключ в заголовке `X-Avala-Api-Key`. Вы можете найти API-ключ в [панели управления Avala](https://avala.ai/settings?section=security) в разделе **Настройки > Безопасность**.

```bash theme={null}
export AVALA_API_KEY="your-api-key"
```

После установки переменной окружения все SDK подхватят её автоматически без дополнительной настройки.

## Интеграция MCP

Используйте Avala с AI-ассистентами, такими как Claude, Cursor и VS Code, через [Model Context Protocol](/docs/integrations/mcp-setup). Пакет `@avala-ai/mcp-server` предоставляет ваши наборы данных, проекты и экспорты как инструменты, которые AI-ассистенты могут вызывать напрямую.