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, 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.4.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.4.0
File Size Uploaded Provenance Actions
e_track-0.4.0.tar.gz 243.2 kB With provenance Details for e_track-0.4.0.tar.gz

Built distribution (wheel)

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

Total release size: 431.3 kB

Release files / e_track-0.4.0.tar.gz

Download URL e_track-0.4.0.tar.gz
Size 243.2 kB
Tags Source
SHA-256 checksum
How to use checksums
bad782a2604e9c9e8d77cdad6085238308c8f8d92ecd991cd0077815204dd101
BLAKE2b-256 checksum
How to use checksums
e2dab6b3f9c565e1dced1cd6b4c5d61ff8e58c15b96eb3f124be770c902e650b
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.4.0-py3-none-any.whl

Download URL e_track-0.4.0-py3-none-any.whl
Size 188.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8562ee5b677647820bc712156c726bba050e3008b48db7f8d6dc622877894109
BLAKE2b-256 checksum
How to use checksums
de87fa5bdbd18df0ecffc50f8e63fcd92bdf85b6d2d10a6fcda3278d3ba2e481
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.4.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.4.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