AgentTrail Python SDK
Client library for tracing agent and LLM workloads: it records spans and sends them to your ingestion endpoint (POST {base_url}/v1/spans). It does not include a server, database, or UI—only instrumentation and export.
Install (PyPI)
pip install agenttrail-sdk
LangGraph, OpenAI, and Anthropic clients are dependencies of this package—customers install once; new framework support ships in new SDK releases, not separate extras.
Developers can use uv with this repo: see pyproject.toml and uv.lock.
Quick usage
Set base_url to your span ingestion service, or set the environment variable AGENTTRAIL_BASE_URL (default if both omitted: http://127.0.0.1:8080).
from agenttrail import init, shutdown
init(
api_key="your-api-key",
project="my-agent",
base_url="https://ingest.example.com",
)
try:
... # app / agents
finally:
shutdown()
By default, init() auto-instruments LangGraph (invoke / ainvoke / stream / astream), OpenAI chat.completions.create, and Anthropic messages.create. Use auto_instrument=False to disable.
Docs
Links use the GitHub repository so they work from PyPI and from this checkout.
| Doc | Purpose |
|---|---|
| QUICKSTART | Examples (LangGraph, OpenAI, Anthropic, manual spans) |
| CONNECTOR_SPEC | Building third-party connectors |
| TESTING | Automated checks and manual smoke tests |
| PUBLISHING | PyPI release (uv build, uv publish) |
| SDK_Plan | Internal roadmap / program context |
Development
cd /path/to/repo # repository root containing pyproject.toml
uv sync
uv run pytest
uv run ruff check src tests
uv run ruff format --check src tests
uv run mypy src
License
Metadata
Release files for agenttrail-sdk 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agenttrail_sdk-0.1.0.tar.gz | 80.5 kB | Without provenance | Details for agenttrail_sdk-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agenttrail_sdk-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for agenttrail_sdk-0.1.0-py3-none-any.whl |
Total release size: 102.9 kB
Release files / agenttrail_sdk-0.1.0.tar.gz
| Download URL | agenttrail_sdk-0.1.0.tar.gz |
|---|---|
| Size | 80.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ee7b35ee873843cd4dbd9a9696cc8b7b0458b955e96e8ba1ad38ab3cbfeac4cd
|
|
BLAKE2b-256 checksum How to use checksums |
51506e06d7c89526cdaec1a2a72ffea17e7fc12fe7761575f73fe42bb14bab39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / agenttrail_sdk-0.1.0-py3-none-any.whl
| Download URL | agenttrail_sdk-0.1.0-py3-none-any.whl |
|---|---|
| Size | 22.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c39c5e9df63e2a12d94d6ff3f7cabb17779a58ccf93205296223a5a288bbca64
|
|
BLAKE2b-256 checksum How to use checksums |
817db7c38a268397b64266cbff83b4e6a7a2adad5924a8a28e96447ce00dd114
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for agenttrail-sdk 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.