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

> Offizielle SDKs und Client-Bibliotheken für die Avala API

Avala bietet offizielle SDKs und Client-Bibliotheken, um Ihnen die Integration mit der Plattform in Ihrer bevorzugten Sprache oder Ihrem bevorzugten Framework zu erleichtern. Jedes SDK umhüllt die Avala REST API mit idiomatischen Methoden, integrierter Authentifizierung, automatischen Wiederholungsversuchen und vollständiger Typsicherheit.

## Client-Bibliotheken

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/docs/de/sdks/python">
    Synchrone und asynchrone Unterstützung. Vollständige Type Hints. Python 3.9+.
  </Card>

  <Card title="TypeScript" icon="js" href="/docs/de/sdks/typescript">
    Vollständig typisiert. Keine Abhängigkeiten. Funktioniert in Node.js, Deno und Bun.
  </Card>

  <Card title="CLI" icon="terminal" href="/docs/de/sdks/cli">
    Datensätze, Exporte und Speicher von Ihrem Terminal aus verwalten. `curl -fsSL https://avala.ai/install.sh | bash`.
  </Card>

  <Card title="REST API" icon="globe" href="/docs/sdks/rest-api">
    Die API direkt aus jeder Sprache mit HTTP-Anfragen nutzen.
  </Card>

  <Card title="OpenAPI" icon="code" href="/docs/sdks/openapi">
    Generieren Sie Ihren eigenen Client aus der OpenAPI-Spezifikation.
  </Card>
</CardGroup>

## Schnellvergleich

| Funktion                      | Python                  | TypeScript                    | CLI                                              | REST API      |
| ----------------------------- | ----------------------- | ----------------------------- | ------------------------------------------------ | ------------- |
| **Installation**              | `pip install avala`     | `npm install @avala-ai/sdk`   | `curl -fsSL https://avala.ai/install.sh \| bash` | Direktes HTTP |
| **Async**                     | Sync + Async            | Async                         | N/A                                              | Beliebig      |
| **Typsicherheit**             | Vollständige Type Hints | Vollständige TypeScript-Typen | N/A                                              | N/A           |
| **Automatische Wiederholung** | Ja                      | Ja                            | Über SDK                                         | Manuell       |
| **Paginierung**               | Integrierte Iteratoren  | Integrierte Iteratoren        | `--limit`-Flag                                   | Manuell       |
| **Abhängigkeiten**            | httpx, pydantic         | Keine (nativer Fetch)         | click, rich                                      | N/A           |

## Umgebungsvariablen

Alle SDKs respektieren die folgenden Umgebungsvariablen, sodass Sie sie einmal konfigurieren und über Ihren gesamten Stack hinweg nutzen können.

| Variable         | Beschreibung                                                                                                                 | Standard                      |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `AVALA_API_KEY`  | Ihr Avala API Key zur Authentifizierung. Wird automatisch verwendet, wenn kein Key an den Client-Konstruktor übergeben wird. | Keiner (erforderlich)         |
| `AVALA_BASE_URL` | Überschreibt die Standard-API-Basis-URL. Nützlich für Self-Hosted-Deployments oder Entwicklungsumgebungen.                   | `https://api.avala.ai/api/v1` |

## Authentifizierung

Alle Anfragen an die Avala API müssen Ihren API Key im `X-Avala-Api-Key` Header enthalten. Sie finden Ihren API Key im [Avala Dashboard](https://avala.ai/settings?section=security) unter **Einstellungen > Sicherheit**.

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

Sobald die Umgebungsvariable gesetzt ist, verwenden alle SDKs sie automatisch ohne zusätzliche Konfiguration.

## MCP-Integration

Nutzen Sie Avala mit KI-Assistenten wie Claude, Cursor und VS Code über das [Model Context Protocol](/docs/integrations/mcp-setup). Das Paket `@avala-ai/mcp-server` stellt Ihre Datensätze, Projekte und Exporte als Werkzeuge bereit, die KI-Assistenten direkt aufrufen können.