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.5

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.5
File Size Uploaded Provenance Actions
akumi-0.7.5.tar.gz 7.9 kB With provenance Details for akumi-0.7.5.tar.gz

Built distribution (wheel)

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

Total release size: 22.4 kB

Release files / akumi-0.7.5.tar.gz

Download URL akumi-0.7.5.tar.gz
Size 7.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f10b5608ce3f2350f1c89edae657a425d38881bdebd9592307d90238c549d2ce
BLAKE2b-256 checksum
How to use checksums
8c9791696b0ee5262c5cacd30c824a5f6cba43eb1a99abb5dcd60b2fff86846c
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 23, 2026.

Transparency log

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

Download URL akumi-0.7.5-py3-none-any.whl
Size 14.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d21c16a4916b3a67fd7d59b603a549f9fbf491dd1e6667b141b635991d15e6ec
BLAKE2b-256 checksum
How to use checksums
c2a87709854f8fe4a567b578927ef6ea79651ee4667fb89eedc6e4e68525a3c4
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 23, 2026.

Transparency log

Security for akumi 0.7.5

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.5.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 23, 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