---
id: aleph-alpha-client
version: "11.5.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# aleph-alpha-client — python client to interact with Aleph Alpha api endpoints

License: permissive · Maintenance: aging · Downloads: 179.0K/mo

## What it is and what it does

This is a Python wrapper for the Aleph Alpha API, a service providing access to large language models and semantic search capabilities. It abstracts the HTTP protocol details, offering both synchronous and asynchronous client interfaces so you can call the API directly from Python code without managing raw HTTP requests.

The package handles authentication, request serialization, and response parsing for tasks like text completion, semantic search (symmetric and asymmetric), and embedding extraction. It depends on requests, aiohttp, and related libraries for networking, plus tokenizers and Pillow for preprocessing text and images. The maintenance status is aging—the last release was 196 days ago—so you should verify that it still tracks the current Aleph Alpha API before adopting it for new projects.

Use it for:

- Call Aleph Alpha's language models for text completion and generation tasks from a Python application.
- Perform semantic search over document collections using the API's embedding and search endpoints.
- Build async pipelines that stream completions or embeddings without blocking.
- Extract hidden embeddings from text or images for downstream machine learning tasks.
- Integrate task-specific endpoints (classification, summarization, etc.) into a larger Python workflow.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for calling the Aleph Alpha API, supporting both synchronous and asynchronous requests for text completion, semantic search, and embeddings.

Yes, if you are actively using Aleph Alpha's API and need a Python interface. The library is straightforward, has low install friction, and carries no known vulnerabilities. However, the aging maintenance status (196 days since last release) means you should verify API compatibility before relying on it for production work, and monitor the repository for updates.

## Install

pip install aleph-alpha-client
uv add aleph-alpha-client
poetry add aleph-alpha-client

## Installing aleph-alpha-client

Before you install: Low install friction with a pure-Python wheel. Maintenance status is aging—last release was 196 days ago and the repository shows no recent commits, though it remains active and unarchived.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it safe for commercial and private projects.

Quickstart:

import os
from aleph_alpha_client import Client, CompletionRequest, Prompt

client = Client(
    token=os.environ["TEST_TOKEN"],
    host=os.environ["TEST_API_URL"],
)
request = CompletionRequest(
    prompt=Prompt.from_text("Provide a short description of AI:"),
    maximum_tokens=64,
)
response = client.complete(request, model="pharia-1-llm-7b-control")
print(response.completions[0].completion)

Requires a valid Aleph Alpha API token and host URL set in environment variables (TEST_TOKEN, TEST_API_URL).

Verify before relying:

- Whether the package actively maintains compatibility with current Aleph Alpha API versions given the 196-day gap since last release.
- Performance characteristics and rate-limiting behavior for high-volume requests.
- Whether async streaming is production-ready or still experimental.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 179.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aleph alpha api client, llm api python client, text completion api, semantic search client, async api wrapper, embedding api client, pharia model client, llm-client, api-wrapper, async-support

[View on SkillFed](https://skillfed.io/packages/aleph-alpha-client) · [View on PyPI](https://pypi.org/project/aleph-alpha-client/)