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.1

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.1
File Size Uploaded Provenance Actions
e_track-0.6.1.tar.gz 280.3 kB With provenance Details for e_track-0.6.1.tar.gz

Built distribution (wheel)

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

Total release size: 490.3 kB

Release files / e_track-0.6.1.tar.gz

Download URL e_track-0.6.1.tar.gz
Size 280.3 kB
Tags Source
SHA-256 checksum
How to use checksums
d56968cbbb916e43b188a307c6262112d38ef644e2203eb35dbbbd0f645b423e
BLAKE2b-256 checksum
How to use checksums
c84e6efe4537dc29ae540ee33e32612b687826700d87c44d9261a60951fcb382
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 12, 2026.

Transparency log

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

Download URL e_track-0.6.1-py3-none-any.whl
Size 210.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a64f5f7248069f964a56df06760222789b68e34cd89a6b4ad5365449a36dd9f3
BLAKE2b-256 checksum
How to use checksums
48a521d6a8a69d82704cd697d564d88378c5c2b82c695723ecf79c569b9941b9
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 12, 2026.

Transparency log

Security for e-track 0.6.1

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.1.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 12, 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