aleph-alpha-client

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 on this page — 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

aleph-alpha-client on PyPI

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

Evidence: aleph_alpha_client-11.5.1-py3-none-any.whl

Tags

More Artificial Intelligence packages