Bibliotecas de cliente
Python
Soporte síncrono y asíncrono. Type hints completos. Python 3.9+.
TypeScript
Completamente tipado. Cero dependencias. Funciona en Node.js, Deno y Bun.
CLI
Gestione datasets, exportaciones y almacenamiento desde su terminal.
curl -fsSL https://avala.ai/install.sh | bash.REST API
Use la API directamente desde cualquier lenguaje con solicitudes HTTP.
OpenAPI
Genere su propio cliente a partir de la especificación OpenAPI.
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 encabezadoX-Avala-Api-Key. Puede encontrar su API key en el panel de Avala en Configuración > Seguridad.
Integración MCP
Use Avala con asistentes de IA como Claude, Cursor y VS Code a través del Model Context Protocol. El paquete@avala-ai/mcp-server expone sus datasets, proyectos y exportaciones como herramientas que los asistentes de IA pueden llamar directamente.