> ## 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 officiels et bibliothèques client pour l'API Avala

Avala fournit des SDKs officiels et des bibliothèques client pour vous aider à intégrer la plateforme depuis votre langage ou framework préféré. Chaque SDK encapsule la REST API Avala avec des méthodes idiomatiques, une authentification intégrée, des réessais automatiques et une sécurité de type complète.

## Bibliothèques client

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/docs/fr/sdks/python">
    Support synchrone et asynchrone. Annotations de type complètes. Python 3.9+.
  </Card>

  <Card title="TypeScript" icon="js" href="/docs/fr/sdks/typescript">
    Entièrement typé. Zéro dépendance. Fonctionne dans Node.js, Deno et Bun.
  </Card>

  <Card title="CLI" icon="terminal" href="/docs/fr/sdks/cli">
    Gérez les jeux de données, exports et le stockage depuis votre terminal. `curl -fsSL https://avala.ai/install.sh | bash`.
  </Card>

  <Card title="REST API" icon="globe" href="/docs/sdks/rest-api">
    Utilisez l'API directement depuis n'importe quel langage avec des requêtes HTTP.
  </Card>

  <Card title="OpenAPI" icon="code" href="/docs/sdks/openapi">
    Générez votre propre client à partir de la spécification OpenAPI.
  </Card>
</CardGroup>

## Comparaison rapide

| Fonctionnalité            | Python                        | TypeScript                  | CLI                                              | REST API    |
| ------------------------- | ----------------------------- | --------------------------- | ------------------------------------------------ | ----------- |
| **Installation**          | `pip install avala`           | `npm install @avala-ai/sdk` | `curl -fsSL https://avala.ai/install.sh \| bash` | HTTP direct |
| **Asynchrone**            | Sync + Async                  | Async                       | N/A                                              | Tous        |
| **Sécurité de type**      | Annotations de type complètes | Types TypeScript complets   | N/A                                              | N/A         |
| **Réessais automatiques** | Oui                           | Oui                         | Via SDK                                          | Manuel      |
| **Pagination**            | Itérateurs intégrés           | Itérateurs intégrés         | Flag `--limit`                                   | Manuel      |
| **Dépendances**           | httpx, pydantic               | Aucune (fetch natif)        | click, rich                                      | N/A         |

## Variables d'environnement

Tous les SDKs respectent les variables d'environnement suivantes, vous pouvez donc les configurer une fois et les utiliser dans toute votre stack.

| Variable         | Description                                                                                                                   | Défaut                        |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `AVALA_API_KEY`  | Votre clé API Avala pour l'authentification. Utilisée automatiquement si aucune clé n'est passée au constructeur du client.   | Aucun (requis)                |
| `AVALA_BASE_URL` | Remplace l'URL de base de l'API par défaut. Utile pour les déploiements auto-hébergés ou les environnements de développement. | `https://api.avala.ai/api/v1` |

## Authentification

Toutes les requêtes à l'API Avala doivent inclure votre clé API dans l'en-tête `X-Avala-Api-Key`. Vous pouvez trouver votre clé API dans le [tableau de bord Avala](https://avala.ai/settings?section=security) sous **Paramètres > Sécurité**.

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

Une fois la variable d'environnement définie, tous les SDKs la récupéreront automatiquement sans configuration supplémentaire.

## Intégration MCP

Utilisez Avala avec des assistants IA comme Claude, Cursor et VS Code via le [Model Context Protocol](/docs/integrations/mcp-setup). Le package `@avala-ai/mcp-server` expose vos jeux de données, projets et exports comme des outils que les assistants IA peuvent appeler directement.