Skip to content

Installation

e-track targets CPython 3.14+. It is pure Python: one wheel for every platform, the viewer's canvas built in.

uv add "e-track[langgraph,otel]"
pip install "e-track[langgraph,otel]"

Extras

The core carries the record, the channel, the bus and the live buffer. Everything that speaks to a framework or a backend is an extra — install what you use:

Extra Brings Install it for
langgraph langchain-core, langgraph tracking LangGraph agents (deepagents included) and reading their graph
otel opentelemetry-sdk, the OTLP/HTTP exporter, e-serde sending to Langfuse, LangSmith, Phoenix, Tempo or any OpenTelemetry collector
viewer litestar, granian, e-serde, rustworkx the live canvas
topology rustworkx laying out a graph without the viewer
all every extra

The core depends on msgspec, structlog, anyio and pydantic-settings only.

Verify

import importlib.metadata

from etrack.logic.api import Tracker

# e.g. 0.1.3
print(importlib.metadata.version("e-track"))

The package ships py.typed: mypy, pyright and ty check your calls against it.

From source

git clone https://github.com/edamlabs/e-track && cd e-track
make install        # uv sync, the canvas's pnpm deps, the prek hooks
make check          # lint · types · architecture · tests
make integration    # real services (docker): a collector and Phoenix, up then down
make ui             # rebuild the viewer's canvas
make docs-serve     # these docs, live at 127.0.0.1:8000

Next: Run it in 3 steps →