Aleph Alpha Integration

Updated on Aug 14, 2026

Use this integration when your app is implemented in Python.

Setup

1. Install SDK

bash

pip install progress-observability

2. Instrument your app

python

Observability.instrument(
    app_name=os.getenv("OBSERVABILITY_APP_NAME"),
    api_key=os.getenv("OBSERVABILITY_API_KEY")
)

3. Complete example

python

import os

from dotenv import load_dotenv
from aleph_alpha_client import Client, CompletionRequest, Prompt

from progress.observability import Observability

load_dotenv()

# LLM INSTRUMENTATION
Observability.instrument(
    app_name=os.getenv("OBSERVABILITY_APP_NAME"),
    api_key=os.getenv("OBSERVABILITY_API_KEY"),
)

def main() -> None:
    client = Client(
        token=os.environ["ALEPH_ALPHA_API_KEY"],
        host=os.getenv("ALEPH_ALPHA_HOST", "https://api.aleph-alpha.com"),
    )

    request = CompletionRequest(
        prompt=Prompt.from_text("What is the capital of France?"),
        maximum_tokens=64,
    )

    response = client.complete(request, model="pharia-1-llm-7b-control")


try:
    main()
finally:
    Observability.shutdown()

To get a richer trace tree when building agents on top of this provider, use the @agent, @tool, @workflow, or @task decorators. See the Python SDK for details.