> ## 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.

# SDKs

> SDKs oficiales y bibliotecas de cliente para la API de Avala

Avala proporciona SDKs oficiales y bibliotecas de cliente para ayudarle a integrarse con la plataforma desde su lenguaje o framework preferido. Cada SDK envuelve la REST API de Avala con métodos idiomáticos, autenticación integrada, reintentos automáticos y seguridad de tipos completa.

## Bibliotecas de cliente

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/docs/es/sdks/python">
    Soporte síncrono y asíncrono. Type hints completos. Python 3.9+.
  </Card>

  <Card title="TypeScript" icon="js" href="/docs/es/sdks/typescript">
    Completamente tipado. Cero dependencias. Funciona en Node.js, Deno y Bun.
  </Card>

  <Card title="CLI" icon="terminal" href="/docs/es/sdks/cli">
    Gestione datasets, exportaciones y almacenamiento desde su terminal. `curl -fsSL https://avala.ai/install.sh | bash`.
  </Card>

  <Card title="REST API" icon="globe" href="/docs/sdks/rest-api">
    Use la API directamente desde cualquier lenguaje con solicitudes HTTP.
  </Card>

  <Card title="OpenAPI" icon="code" href="/docs/sdks/openapi">
    Genere su propio cliente a partir de la especificación OpenAPI.
  </Card>
</CardGroup>

## Comparación rápida

| Característica             | Python                | TypeScript                  | CLI                                              | REST API     |
| -------------------------- | --------------------- | --------------------------- | ------------------------------------------------ | ------------ |
| **Instalación**            | `pip install avala`   | `npm install @avala-ai/sdk` | `curl -fsSL https://avala.ai/install.sh \| bash` | HTTP directo |
| **Async**                  | Síncrono + Async      | Async                       | N/A                                              | Cualquiera   |
| **Seguridad de tipos**     | Type hints completos  | Tipos TypeScript completos  | N/A                                              | N/A          |
| **Reintentos automáticos** | Sí                    | Sí                          | Vía SDK                                          | Manual       |
| **Paginación**             | Iteradores integrados | Iteradores integrados       | Flag `--limit`                                   | Manual       |
| **Dependencias**           | httpx, pydantic       | Ninguna (fetch nativo)      | click, rich                                      | N/A          |

## Variables de entorno

Todos los SDKs respetan las siguientes variables de entorno, para que pueda configurarlos una vez y usarlos en toda su pila.

| Variable         | Descripción                                                                                                            | Valor por defecto             |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `AVALA_API_KEY`  | Su API key de Avala para autenticación. Se usa automáticamente si no se pasa ninguna clave al constructor del cliente. | Ninguno (requerido)           |
| `AVALA_BASE_URL` | Sobrescribir la URL base de la API por defecto. Útil para despliegues auto-alojados o entornos de desarrollo.          | `https://api.avala.ai/api/v1` |

## Autenticación

Todas las solicitudes a la API de Avala deben incluir su API key en el encabezado `X-Avala-Api-Key`. Puede encontrar su API key en el [panel de Avala](https://avala.ai/settings?section=security) en **Configuración > Seguridad**.

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

Una vez configurada la variable de entorno, todos los SDKs la detectarán automáticamente sin configuración adicional.

## Integración MCP

Use Avala con asistentes de IA como Claude, Cursor y VS Code a través del [Model Context Protocol](/docs/integrations/mcp-setup). El paquete `@avala-ai/mcp-server` expone sus datasets, proyectos y exportaciones como herramientas que los asistentes de IA pueden llamar directamente.