Skip to content
Davirix

First execution in 5 minutes

PartialThe SDK and execution API work. The verification chain is complete in code but not yet proven on a live stand.

Work through this page and you will have a working execution plus code that reads the result correctly.

You will need

Section titled “You will need”
Python 3.10+
Key DAVIRIX_KEY — from the console
Tenant tenant_id — your organisation identifier

Steps

Section titled “Steps”

  1. Install

    Section titled “Install”
    Terminal window
    pip install davirix

    Pure Python (py3-none-any) — identical on Linux, macOS and Windows.

  2. Put the key in your environment

    Section titled “Put the key in your environment”
    Terminal window
    export DAVIRIX_KEY="dx_..."

  3. Check the connection

    Section titled “Check the connection”
    import os
    from davirix import Davirix
    

    dx = Davirix(api_key=os.environ["DAVIRIX_KEY"], tenant_id="bank-uz")
    print(dx)   # <Davirix base_url='https://api.davirix.com' tenant_id='bank-uz'>

  4. Send your first execution

    Section titled “Send your first execution”
    n = dx.run(
        agent_id="card-support",
        input={"text": "Block the card ending 7731"},
        idempotency_key="order-2026-08-12-0001",
    )

  5. Read the result correctly

    Section titled “Read the result correctly”
    n.status        # "completed" — the model replied
    n.verified      # ⚡ was the ACTION confirmed against the source
    n.unknown       # is the outcome unknown
    

    for op in n.operations:
        print(op.capability_id, op.status)

    ⛔ Reading n.status == "completed" as “done” is the most common mistake. Why, and the correct pattern: the one rule that matters.

  6. Separate your errors

    Section titled “Separate your errors”
    from davirix import APIError
    

    try:
        n = dx.run(...)
    except APIError as e:
        if e.retryable:
            ...      # retrying is SAFE
        else:
            ...      # retrying will not fix it

Next

Section titled “Next”