Skip to main content

AgentTrace Python SDK - Drop-in tracing for any AI agent

Project description

agenttrace-io (Python SDK)

Drop-in tracing for any AI agent. Local SQLite storage, zero dependencies, zero cloud.

Installation

pip install agenttrace-io

Requires Python 3.10+.

Quickstart

from agenttrace import init, trace

agent = init(db_path="./traces.db")

# Trace a callable
result = agent.trace("my-op", lambda: 42 * 2)

# Use as decorator
@trace("greet")
def greet(name: str) -> str:
    return f"Hello, {name}"

# Use as context manager
with agent.trace("context-op") as t:
    value = "computed"
    t.set_output(value)

# Query and export
traces = agent.get_traces()
stats = agent.get_stats()
agent.export("json")
agent.close()

See the full README for more.

License

MIT © Klepsiphron

Project details


Download files

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

Source Distribution

agenttrace_io-0.2.0.tar.gz (26.6 kB view details)

Uploaded Source

Built Distribution

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

agenttrace_io-0.2.0-py3-none-any.whl (18.0 kB view details)

Uploaded Python 3

File details

Details for the file agenttrace_io-0.2.0.tar.gz.

File metadata

  • Download URL: agenttrace_io-0.2.0.tar.gz
  • Upload date:
  • Size: 26.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agenttrace_io-0.2.0.tar.gz
Algorithm Hash digest
SHA256 55319b5f39c562fe2ad6b7f09f8158c0f2eb233ba4894258e0bb7d0c19e891d6
MD5 202ab038093acb64883cbd5caeb9c820
BLAKE2b-256 1f4e1f874c85fb21c417fee7e3d969bdcb7c2011a579a7e41cbe4f1de9bffb4c

See more details on using hashes here.

Provenance

The following attestation bundles were made for agenttrace_io-0.2.0.tar.gz:

Publisher: release.yml on Klepsiphron/agenttrace

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

File details

Details for the file agenttrace_io-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: agenttrace_io-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 18.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agenttrace_io-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eb68e3f7ceaac82dc7ec42cc92fe741059182059802658a0577b28656ba78ef0
MD5 17a722b0fef3d38db00db39edb903fe1
BLAKE2b-256 b46df2b999f0feb0a0c9e5420b05934a8cc6d8d8d9c5b0e5b5ee37d1c6359aa8

See more details on using hashes here.

Provenance

The following attestation bundles were made for agenttrace_io-0.2.0-py3-none-any.whl:

Publisher: release.yml on Klepsiphron/agenttrace

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page