Installation¶

Pick the surface you need. All three talk to the same API.

Hosted API — nothing to install¶

export VENKAI_API_KEY="vk_live_…"
curl -s https://api.venkai.fr/api/health

Any HTTP client in any language works. This is the recommended way to integrate today. See REST API.

Python SDK¶

Beta

The SDK is not yet published on PyPI — there is no pip install venkai today. During the beta it is available on request; it is a thin wrapper over the REST API, so anything it does you can do with plain HTTP.

Once installed:

from venkai.sdk.client import VenkaiClient

client = VenkaiClient(
    api_key="vk_live_…",
    base_url="https://api.venkai.fr",   # required: the default is localhost
    project="billing-service",
)

base_url defaults to http://127.0.0.1:8000

Against the hosted API you must pass base_url="https://api.venkai.fr" explicitly, or every call fails with a connection error.

Full surface: Python SDK.

MCP server¶

Beta

A stdio MCP server that talks to the hosted API over HTTPS. Like the SDK, it is available on request during the beta. Configuration: MCP.

Private deployment¶

Venkai can also run inside your own infrastructure. See Deployment options.