Repository navigation
Tracekit 1.0.0
Install: pip install tracekit-ai — then add import tracekit; tracekit.instrument() to your agent and run tracekit last. Container image: ghcr.io/cygnux-labs/tracekit-signer:v1.0.0 (@sha256:d9cbad7dc635959d9812ec7a7507c5d306199285d29a29aa2f7839ee583c8e95).
Verify this release: the wheel and sdist below are the files PyPI serves (SHA256SUMS); each carries SLSA build provenance from this repository's release workflow (gh attestation verify tracekit_ai-1.0.0-py3-none-any.whl --repo Cygnux-Labs/Tracekit), the image is cosign-signed (keyless), and the CycloneDX SBOMs of the package and the image are attached. The npm packages (@cygnux/tracekit) are not published for 1.0.0 yet; use the TypeScript SDK from this repository until they are. Known limits and trade-offs: docs/limits.md.
1.0.0 is 1.0.0rc2 made stable: the v2 signer, evidence format v2 and its verifier, witnesses, the monitor, team approvals,
server deployments (container, Kubernetes sidecar, central signer on Postgres) and the run viewer. The v2 format is now
stable: 1.x verifiers verify every 1.0 bundle, and a bundle that needs a newer verifier says so (UNVERIFIABLE), never
FAILED. The v1 laptop setup and v1 bundles keep working unchanged. Upgrade notes from 0.4.0: see 1.0.0rc1 below.
Added
- One install, one line, a verified run.
pip install tracekit-ainow installs everything the dev signer needs
(tracekit-ai[signer]still works);pip install --no-deps tracekit-aiis the verifier alone, on the standard
library.import tracekit; tracekit.instrument()wires the frameworks it finds (OpenAI Agents SDK, LangGraph /
LangChain, Claude Agent SDK, MCP, and the OpenAI, Anthropic and Google Gen AI SDKs), starting a dev signer if none
is running.tracekit lastexports the newest finished run, pins the dev signer's key and verifies it. The README
and each framework quickstart are those three steps. What this path doesn't cover:
docs/limits.md. - docs/limits.md: every known limit and trade-off on one page.
Changed
tracekit.instrument(tracer)(v1 model-call tracing) is nowtracekit.autotrace.instrument(tracer);
tracekit.instrument()raises aTypeErrornaming it when given a tracer.
Fixed
- A network service that refused a request before reading its body (wrong Host, missing session or CSRF token) could
reset the connection before the client read the answer, on Windows always and elsewhere while a large body was
still arriving. Each service now reads what the client sent, up to 1 MiB, before closing. - A config file written as JSON (
signer.yaml, the viewer's and the gateway's) failed to load where PyYAML isn't
installed, whichtracekit-ai[signer]doesn't install. JSON documents now load either way.
Release
- npm: no
@cygnux/tracekit-signer-darwin-x64package (google-re2 and cryptography publish no Intel-Mac wheels it can
use). On an Intel Mac,pip install 'tracekit-ai[signer]';@cygnux/tracekituses thattracekitfrom PATH. - Releases are built and published by the attested release workflow: PyPI files, npm packages and the signer image
carry SLSA build provenance and SBOMs, the image is cosign-signed, andSHA256SUMSis attached to the GitHub release
(docs/RELEASING.md). - SECURITY.md: 1.x is the supported line.