zanii-llm-client

Python client for Zanii LLM: OpenAI-compatible inference where every call can produce a signed receipt on a public ledger.

pip install zanii-llm-client            # add [verify] to check proofs client-side

from zanii_llm_client import Zanii

z = Zanii()                                       # reads ZANII_LLM_API_KEY
answer = z.chat("Summarise this claim in two sentences.", model="glm-4.7-flash")

print(answer.text)
print(answer.cost_aed, "AED")
print(z.verify(answer.receipt).ok)

No dependencies. A dependency in a client package becomes a dependency in every application that installs it.

You may not need this

The API speaks the OpenAI protocol, so the openai package works with one changed base URL and will keep working:

from openai import OpenAI
client = OpenAI(api_key="zlk_live_...", base_url="https://llm.zanii.agency/v1")

This package adds the parts no OpenAI client knows about.

Reasoning costs money

These models reason before they answer. Reasoning tokens are billed like any other and come out of max_tokens. Measured on glm-4.7-flash, "name one thing Sharjah is known for" costs 412 output tokens and 4.4 seconds with reasoning on, and 22 tokens and 0.6 seconds with it off, for the same answer.

z.chat("Name one thing Sharjah is known for.", model="glm-4.7-flash", thinking=False)

If answer.text comes back empty, answer.empty_because says why and answer.reasoning_tokens says where the budget went.

Streaming

for piece in z.stream("Write three lines about Dubai.", model="glm-4.7-flash"):
    print(piece, end="", flush=True)

print(z.last)                                      # the receipt, once the stream ends

Verifying a receipt

check = z.verify(answer.receipt)
assert check.ok
assert check.detail["verified_locally"]            # True with the [verify] extra installed

Verification fetches a Merkle inclusion proof from ledger.zanii.agency and checks it against a signed tree head. It does not call Zanii LLM at all.

Parity

The TypeScript client @zanii/llm mirrors this one method for method. A conformance suite runs the same cases through both and fails on a difference.

© Zanii, United Arab Emirates · llm.zanii.agency · info@zanii.agency