SledTrace Python SDK
SledTrace is a local-first observability and debugging SDK for RAG pipelines.
Current release: 0.7.0 — External Developer Readiness
Project and visual overview: github.com/Schromeo/SledTrace
Distribution status
Install the released SDK and CLI from production PyPI:
python -m pip install sledtrace==0.7.0
The immutable 0.7.0rc1 publication candidate remains available on TestPyPI for release-history purposes.
Install from source for development
cd sdk/python
python -m pip install -e .
Build a local wheel or sdist
cd sdk/python
python -m pip install --upgrade pip
python -m pip install build
python -m build
This produces wheel and source-distribution artifacts in dist/.
Install the built wheel
python -m pip install dist/*.whl
CLI
Editable and wheel installations provide:
sledtrace --help
sledtrace serve --help
sledtrace version
sledtrace version reports 0.7.0 for this release.
sledtrace serve must be run from inside a SledTrace source checkout. It locates the repository from the current working directory and delegates to scripts/start-sledtrace.py. The wheel does not bundle the Collector, Dashboard, Docker assets, or a standalone serving runtime; outside a checkout, serve exits with actionable guidance.
Basic usage
from sledtrace import trace
with trace("example") as t:
t.retrieval(
query="What is the refund policy?",
chunks=[
{
"id": "chunk-1",
"text": "Refunds are accepted within 30 days with proof of purchase.",
"score": 0.92,
"metadata": {"source": "refund_policy.md"},
}
],
top_k=1,
)
t.llm(
model="demo-model",
prompt="Question: What is the refund policy?",
response="Refunds are accepted within 30 days with proof of purchase.",
provider="local-demo",
)
t.flush()
Collector URL configuration
The default collector URL is http://localhost:4319.
Use the SledTrace environment variable:
export SLEDTRACE_COLLECTOR_URL=http://localhost:4319
PowerShell:
$env:SLEDTRACE_COLLECTOR_URL="http://localhost:4319"
Legacy compatibility remains temporarily supported for migration:
export RAGLENS_COLLECTOR_URL=http://localhost:4319
The precedence is:
SLEDTRACE_COLLECTOR_URLRAGLENS_COLLECTOR_URLhttp://localhost:4319
Legacy compatibility note
Legacy raglens imports remain temporarily supported during migration, but new code should use the SledTrace package path:
from sledtrace import trace
More docs
- Full project README and screenshots
- User onboarding guide
- Python SDK integration guide
- v0.7.0 release
Repository examples such as examples.custom_pipeline_demo are local developer examples and not a separate public SDK surface.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file sledtrace-0.7.0.tar.gz.
File metadata
- Download URL: sledtrace-0.7.0.tar.gz
- Upload date:
- Size: 14.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a47b144a68a1c6d540a5e7beeb9b7d7bb73a077d2d7f319c27945eeced9d57dd
|
|
| MD5 |
8c265577dec67907b639f341870f9cba
|
|
| BLAKE2b-256 |
f9fb8094d660442f62e264d29540396c248fe5da2e820a755f30e4f503eb39dc
|
Provenance
The following attestation bundles were made for sledtrace-0.7.0.tar.gz:
Publisher:
publish-python.yml on Schromeo/SledTrace
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sledtrace-0.7.0.tar.gz -
Subject digest:
a47b144a68a1c6d540a5e7beeb9b7d7bb73a077d2d7f319c27945eeced9d57dd - Sigstore transparency entry: 2774147872
- Sigstore integration time:
-
Permalink:
Schromeo/SledTrace@58887907973aff3948d2cf3667681832f4305ec6 -
Branch / Tag:
refs/tags/v0.7.0 - Owner: https://github.com/Schromeo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-python.yml@58887907973aff3948d2cf3667681832f4305ec6 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file sledtrace-0.7.0-py3-none-any.whl.
File metadata
- Download URL: sledtrace-0.7.0-py3-none-any.whl
- Upload date:
- Size: 12.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d490385d787b115317063bc3ca4d6652302b0ec2b760cfde64be54092a4dc636
|
|
| MD5 |
6a850fef73a5ab671bc374c5c9ede58d
|
|
| BLAKE2b-256 |
9a712f4a599e527f2be69745b17c30d42721b0efeddf2b7ec05b7643d51074a5
|
Provenance
The following attestation bundles were made for sledtrace-0.7.0-py3-none-any.whl:
Publisher:
publish-python.yml on Schromeo/SledTrace
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
sledtrace-0.7.0-py3-none-any.whl -
Subject digest:
d490385d787b115317063bc3ca4d6652302b0ec2b760cfde64be54092a4dc636 - Sigstore transparency entry: 2774148091
- Sigstore integration time:
-
Permalink:
Schromeo/SledTrace@58887907973aff3948d2cf3667681832f4305ec6 -
Branch / Tag:
refs/tags/v0.7.0 - Owner: https://github.com/Schromeo
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-python.yml@58887907973aff3948d2cf3667681832f4305ec6 -
Trigger Event:
workflow_dispatch
-
Statement type:
