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, 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, any OpenTelemetry collector
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.3.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.3.0
File Size Uploaded Provenance Actions
e_track-0.3.0.tar.gz 237.0 kB With provenance Details for e_track-0.3.0.tar.gz

Built distribution (wheel)

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

Total release size: 424.7 kB

Release files / e_track-0.3.0.tar.gz

Download URL e_track-0.3.0.tar.gz
Size 237.0 kB
Tags Source
SHA-256 checksum
How to use checksums
5af0a845a6a8912fcf5b1a01034eac91924120d3a107e26dbedd315e65561e7b
BLAKE2b-256 checksum
How to use checksums
ef287ace85656f9bd36a96e3829f9cbb46d6f0f53336235b4e467d4300c93663
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 4, 2026.

Transparency log

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

Download URL e_track-0.3.0-py3-none-any.whl
Size 187.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d67bee83b05c4deae6e8a25c492981bdc32e6d84a0503e82934597e171b64c74
BLAKE2b-256 checksum
How to use checksums
3da0311fbe180115c92ef215631cd8800430b02b1c17af67150b86016f13d901
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 4, 2026.

Transparency log

Security for e-track 0.3.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.3.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 4, 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