Skip to main content

Sovara Python SDK

The sovara package instruments Python agents so Sovara can record LLM calls, tool calls, logs, and custom trace spans.

Install it in the Python environment where your agent runs:

python -m pip install sovara

Or with uv:

uv add sovara

Create a project-bound client and use it to record runs:

from sovara import SovaraClient

sovara_client = SovaraClient(project_name="My Project")

with sovara_client.run("support-agent"):
    run_agent()

For a remote/headless agent, pass the exec server and project token directly:

import os

sovara_client = SovaraClient(
    project_name="My Project",
    base_url="https://exec.example.com",
    agent_token=os.environ["SOVARA_AGENT_TOKEN"],
)

http_client= optionally accepts a caller-owned synchronous httpx.Client for custom proxy, certificate, or transport behavior. Sovara does not close it.

The terminal command is distributed separately as the native Sovara CLI. Install that CLI for commands such as sovara record, sovara status, and sovara probe.

Documentation: https://docs.sovara-labs.com

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sovara-0.4.12-py3-none-any.whl (81.3 kB view details)

Uploaded Python 3

File details

Details for the file sovara-0.4.12-py3-none-any.whl.

File metadata

  • Download URL: sovara-0.4.12-py3-none-any.whl
  • Upload date:
  • Size: 81.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for sovara-0.4.12-py3-none-any.whl
Algorithm Hash digest
SHA256 3887ad01a4ac6f0eb7a795cbda251bb8a55319f800b692e82910e7cc8f7250f4
MD5 05cca32e5e9e734d7f2304e84487ec10
BLAKE2b-256 10c73f019f41ad37a40c05854416829f03eb2677bde0fa0ad4a8a4104d49b142

See more details on using hashes here.

Provenance

The following attestation bundles were made for sovara-0.4.12-py3-none-any.whl:

Publisher: python-sdk-release.yaml on SovaraLabs/sovara

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.5.0

1 file

0.4.15

1 file

0.4.14

1 file

0.4.13

1 file

This release

0.4.12 This release

1 file

0.4.11

1 file

0.4.10

1 file

0.4.9

1 file

0.4.8

1 file

0.4.7

1 file

0.4.6

1 file

0.4.5

1 file

0.4.4

1 file

0.4.0

1 file

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.1

2 files

0.2.0

2 files

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