Skip to main content

Akumi Python SDK

The official Python client for Akumi, the EU-sovereign, OpenAI-compatible inference API. Built on httpx, with both a synchronous and an asynchronous client. One base_url for every model, governed and metered, with your regulated data kept in the EU.

  • Drop-in OpenAI-compatible. Chat completions, embeddings, and models under one key.
  • EU-sovereign by default. The egress guard fails closed on non-EU routing.
  • Governed, not just hosted. PII firewall, per-request residency, and a metadata-only audit trail on every call.
  • Sync and async. Streaming and automatic retries in both clients.

Requirements

Python 3.9 or newer.

Install

pip install akumi

Quickstart

Create an API key under app.akumi.eu -> Platform -> API keys:

from akumi import Akumi

client = Akumi.from_api_key("mk_...")

result = client.chat.create(params={
    "model": "mistral/mistral-large-latest",
    "messages": [
        {"role": "user", "content": "Explain EU data residency in one sentence."},
    ],
})

print(result["choices"][0]["message"]["content"])

Streaming

for chunk in client.chat.create_streamed(params={
    "model": "mistral/mistral-large-latest",
    "messages": [{"role": "user", "content": "Write a haiku about Frankfurt."}],
}):
    print(chunk["choices"][0]["delta"].get("content", ""), end="")

Async

import asyncio
from akumi import AsyncAkumi

async def main():
    client = AsyncAkumi.from_api_key("mk_...")
    result = await client.chat.create(params={
        "model": "mistral/mistral-large-latest",
        "messages": [{"role": "user", "content": "Hello from the EU."}],
    })
    print(result["choices"][0]["message"]["content"])

asyncio.run(main())

Embeddings

embeddings = client.embeddings.create(params={
    "model": "mistral/mistral-embed",
    "input": "The quarterly report is ready for review.",
})

vector = embeddings["data"][0]["embedding"]

More resources

  • client.models.list() lists the models available to your key.
  • client.memory.forget(...) and client.memoryThreads.list() manage long-term memory and threads.
  • client.auditLogs.list() reads your metadata-only audit trail.

Configuration

from_api_key() connects to https://api.akumi.eu/v1 and retries transient failures (429, 502, 503, 504). Pass base_url= to target another host.

Documentation

About

Generated from the Akumi OpenAPI specification, so it tracks the API automatically. Issues: https://github.com/akumi-cloud/python-sdk.

MIT licensed.

Metadata

Release files for akumi 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for akumi 0.7.1
File Size Uploaded Provenance Actions
akumi-0.7.1.tar.gz 8.4 kB With provenance Details for akumi-0.7.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for akumi 0.7.1
File Interpreter ABI Platform Actions
akumi-0.7.1-py3-none-any.whl Python 3 none any Details for akumi-0.7.1-py3-none-any.whl

Total release size: 24.2 kB

Release files / akumi-0.7.1.tar.gz

Download URL akumi-0.7.1.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
66cfc19254188259b55c583e7b000c92415cd2ca9d2efa8b2d30ced8571c216d
BLAKE2b-256 checksum
How to use checksums
e56808d4a40bfc44dff9394446561bf31c65444dab8830e62585d33b03cda0fa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.

Transparency log

Release files / akumi-0.7.1-py3-none-any.whl

Download URL akumi-0.7.1-py3-none-any.whl
Size 15.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cb04bbd897130712f82dffd70d4d22f4f58c1a31f03ff9c796da20d01ba550e4
BLAKE2b-256 checksum
How to use checksums
a3ab9e8dd0bfeb403b49e8a6c88415bc6fa6643dcc957a98d9177252f6d1375c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.

Transparency log

Security for akumi 0.7.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for akumi-0.7.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page