Installation

TraceAgent requires Python 3.11+ and can be installed via pip, Docker, or from source.

Install via pip

Each package can be installed independently:

All Packages

pip install trace-agent-sdk trace-agent-langchain trace-agent-server trace-agent-ui

SDK Only

pip install trace-agent-sdk

SDK + LangChain

pip install trace-agent-sdk trace-agent-langchain

tip

If you only need to instrument your agent (and the server runs elsewhere), install just the SDK. The server and UI are only needed for the self-hosted backend.

Docker

Pre-built images are available for the backend and frontend:

Component	Image
TraceAgent Server	ghcr.io/lixussoftware/trace-agent-server:latest
TraceAgent UI	ghcr.io/lixussoftware/trace-agent-ui:latest

# Pull the images
docker pull ghcr.io/lixussoftware/trace-agent-server:latest
docker pull ghcr.io/lixussoftware/trace-agent-ui:latest

For a full Docker Compose setup, see the Docker deployment guide.

From Source

git clone https://github.com/LixusSoftware/TraceAgent.git
cd TraceAgent

uv (recommended)

uv sync --extra dev --extra providers --extra langchain

pip

pip install -e ".[dev,providers,langchain]"

Verify Installation

python -c "from trace_agent_sdk import TraceAgentClient; print('TraceAgent SDK ready ✓')"

What's Next?

Head to the Quick Start to create your first trace in under 5 minutes.