Voker logo

Python

Installation

pip install voker

Make sure to set the environment variable VOKER_API_KEY.

Quick Start

If you're using one of our supported SDKs, you can simply swap out the class you instantiate:

from openai import OpenAI  
from voker.ai.provider_openai import OpenAI  

client = OpenAI()

client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[
        {
            "role": "user",
            "content": "Hello, world!",
        }
    ],
)

See provider specific setup instructions:

Python SDK Reference

Voker Client

The Voker Client provides a way to create an update Agents, Agent Versions, People and Events programmatically.

Requests are made in a separate thread as the main process as to not add latency to your application. This is used by the SDKs but can also be used directly if you want more control over when requests are sent.

API Client

The API Client provides a way to make requests to the Voker API directly. This is used under the hood by the Voker Client, but can also be used directly if you want more control over how requests are made.

Fetching Agents, Agent Versions, and People is a common use cases for using the API Client directly.

Types

  • Class Agent

    Represents an agent.

    See Agents for more information.

    Fields

    • agent_name: str

      Unique identifier for the agent.

    • description: str | None

    • agent_number: int

      Unique number assigned to the agent.

    • created_at: datetime

    • deprecated_at: datetime | None

  • Class AgentVersion

    Represents an agent version.

    See Agent Versions for more information.

    Fields

    • agent_version_name: str

      Unique identifier for the agent version within its agent.

    • description: str | None

    • agent_version_number: int

      Unique number assigned to the agent version within its agent.

    • created_at: datetime

    • deprecated_at: datetime | None

  • Class Fingerprint

    Represents a fingerprint.

    See Fingerprints for more information.

    Fields

    • fingerprint_id: str

  • Class Person

    Represents a person.

    See People for more information.

    Fields

    • person_id: str

    • properties: dict[str, Any] | None

    • created_at: datetime