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.