Skip to main content

CI PyPI Python License

e-track

See what your agents are doing. e-track turns every run of a LangGraph agent — its nodes, model calls, tools, MCP calls and subagents — into one stream of events, and sends it wherever you look: Langfuse, Phoenix, LangSmith, any OpenTelemetry backend, your own code, or a live canvas of the graph. Adding a backend never touches the agent, and a slow backend never slows it.

Part of the EDamLabs eager series: EDamLabs' own e- products (EDamLabs families).

The live viewer: the agent's graph lit by its run, the calls of each node counted inside it, the span tree with every span's input and output

Install

uv add "e-track[langgraph,otel]"    # or: pip install "e-track[langgraph,otel]"
Extra For
langgraph tracking LangGraph agents (deepagents included)
otel Langfuse, LangSmith, Phoenix, Tempo, Cloud Trace, any OpenTelemetry collector
http any HTTP endpoint — the base of a custom driver (a memory service, a webhook)
prometheus run metrics for Prometheus and Grafana
viewer the live canvas (Litestar on granian, React Flow)
all everything

Python 3.14+, typed (py.typed).

Usage

from etrack.logic.api import Tracker
from etrack.logic.channel import EventChannel
from etrack.providers.adapters.bus.anyio import AnyioAdapter
from etrack.providers.adapters.source.langgraph import LanggraphSourceAdapter
from etrack.providers.drivers.sink.otlp import OtlpDriver

async with OtlpDriver() as otlp:                     # targets from ETRACK_OTLP_TARGETS
    bus = AnyioAdapter()
    bus.subscribe(otlp)                              # and the live buffer, and your own sinks
    async with bus:
        tracker = Tracker(EventChannel(bus), LanggraphSourceAdapter())
        with tracker.track(thread="t1", config={}) as run:
            await agent.ainvoke(inputs, run.config)  # your graph, untouched: the config carries the hook
ETRACK_OTLP_TARGETS='{"phoenix": {"endpoint": "http://localhost:6006"}}'

And the live canvas, one line more:

viewer = Viewer(watch=live, topology=LanggraphTopologyAdapter().read(agent))
async with GranianAdapter(viewer.app) as server:     # http://127.0.0.1:28130 — or mount viewer.app in your app
    ...
Read For
Quickstart three steps on a small graph, every output shown
The record what an event holds: kinds, phases, the fields
Backends Langfuse, Phoenix, LangSmith, Tempo — settings and what is verified
Viewer serve or mount the canvas, its API

The full guide lives at edamlabs.github.io/e-track.

Development

make install        # sync deps + prek hooks
make check          # lint + type + arch + validate + test
make cov            # coverage gate: 100 % lines and branches, every outbound service faked in process
make integration    # real services: the session fixtures bring tests/sandbox/compose.yml up and down (collector + Phoenix)
make ci             # every gate CI runs, in one command

Stack: uv · ruff · ty · tach · pytest (xdist, randomly, pytest-docker) · prek · zizmor · Zensical · Renovate. Released from a v* tag through PyPI trusted publishing; maintained by the EDamLabs fleet.

Metadata

Release files for e-track 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for e-track 0.6.0
File Size Uploaded Provenance Actions
e_track-0.6.0.tar.gz 278.2 kB With provenance Details for e_track-0.6.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for e-track 0.6.0
File Interpreter ABI Platform Actions
e_track-0.6.0-py3-none-any.whl Python 3 none any Details for e_track-0.6.0-py3-none-any.whl

Total release size: 487.8 kB

Release files / e_track-0.6.0.tar.gz

Download URL e_track-0.6.0.tar.gz
Size 278.2 kB
Tags Source
SHA-256 checksum
How to use checksums
3cccdd0b97d42e97a05d078b948822450a4eaa7afbc4b728f1bb929c82a3b29f
BLAKE2b-256 checksum
How to use checksums
0b825e6e1a1e574d7cef576e7a0e38685f511eaff4f933d2c6e785297d014587
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Release files / e_track-0.6.0-py3-none-any.whl

Download URL e_track-0.6.0-py3-none-any.whl
Size 209.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4520e0619a0d57def56f0f54442c98aed8a0575a17801e45ad78af6e60f855b7
BLAKE2b-256 checksum
How to use checksums
4fcf4e61416ad4bcd06b90a68a9bc6e79f4a444890e68cb8fa94e7d60ee537ae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

Security for e-track 0.6.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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for e_track-0.6.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 11, 2026.

Transparency log

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.

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