Avala provides official SDKs and client libraries to help you integrate with the platform from your preferred language or framework. Each SDK wraps the Avala REST API with idiomatic methods, built-in authentication, automatic retries, and full type safety.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.
Client Libraries
Python
Sync and async support. Full type hints. Python 3.9+.
TypeScript
Fully typed. Zero dependencies. Works in Node.js, Deno, and Bun.
CLI
Manage datasets, exports, and storage from your terminal. curl -fsSL https://avala.ai/install.sh | bash.
REST API
Use the API directly from any language with HTTP requests.
OpenAPI
Generate your own client from the OpenAPI specification.
Quick Comparison
| Feature | Python | TypeScript | CLI | REST API |
|---|---|---|---|---|
| Install | pip install avala | npm install @avala-ai/sdk | curl -fsSL https://avala.ai/install.sh | bash | Direct HTTP |
| Async | Sync + Async | Async | N/A | Any |
| Type Safety | Full type hints | Full TypeScript types | N/A | N/A |
| Auto Retries | Yes | Yes | Via SDK | Manual |
| Pagination | Built-in iterators | Built-in iterators | --limit flag | Manual |
| Dependencies | httpx, pydantic | None (native fetch) | click, rich | N/A |
Environment Variables
All SDKs respect the following environment variables, so you can configure them once and use them across your entire stack.| Variable | Description | Default |
|---|---|---|
AVALA_API_KEY | Your Avala API key for authentication. Used automatically if no key is passed to the client constructor. | None (required) |
AVALA_BASE_URL | Override the default API base URL. Useful for self-hosted deployments or development environments. | https://api.avala.ai/api/v1 |
Authentication
All requests to the Avala API must include your API key in theX-Avala-Api-Key header. You can find your API key in the Avala dashboard under Settings > Security.
MCP Integration
Use Avala with AI assistants like Claude, Cursor, and VS Code through the Model Context Protocol. The@avala-ai/mcp-server package exposes your datasets, projects, and exports as tools that AI assistants can call directly.