Saltar al contenido principal

Instalación

TraceAgent requiere Python 3.11+ (probado en 3.11, 3.12 y 3.13) y se puede instalar con pip o uv, con Docker o desde el código fuente.

Instalar con pip o uv​

Cada paquete se puede instalar de forma independiente, con pip o con uv:

pippip install trace-agent-sdk trace-agent-langchain trace-agent-pydantic-ai trace-agent-server trace-agent-ui
uvuv add trace-agent-sdk trace-agent-langchain trace-agent-pydantic-ai trace-agent-server trace-agent-ui

TraceAgent se compone de cinco paquetes: trace-agent-sdk, trace-agent-server, trace-agent-langchain, trace-agent-pydantic-ai y trace-agent-ui. El paquete de Pydantic AI requiere Pydantic AI 2.x. Si trazas mediante OpenTelemetry, no necesitas ningún paquete de TraceAgent en el agente, solo en el servidor.

uv add frente a uv pip install

uv add añade los paquetes al pyproject.toml de tu proyecto y los instala. Si solo quieres instalar en un entorno existente sin proyecto, usa uv pip install.

tip

Si solo necesitas instrumentar tu agente (y el servidor se ejecuta en otro sitio), instala únicamente el SDK. El servidor y la UI solo hacen falta para el backend autoalojado.

Docker​

Hay imágenes ya construidas para el backend y el frontend:

ComponenteImagen
TraceAgent Serverghcr.io/lixussoftware/trace-agent-server:latest
TraceAgent UIghcr.io/lixussoftware/trace-agent-ui:latest
# Descarga las imágenes
docker pull ghcr.io/lixussoftware/trace-agent-server:latest
docker pull ghcr.io/lixussoftware/trace-agent-ui:latest

Para una configuración completa con Docker Compose, consulta la guía de despliegue con Docker.

Desde el código fuente​

git clone https://github.com/LixusSoftware/TraceAgent.git
cd TraceAgent
uv sync --extra dev --extra providers --extra langchain --extra pydantic-ai

Verificar la instalación​

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

¿Y ahora qué?​

Ve al Inicio rápido para crear tu primera traza en menos de 5 minutos.

💬 Comentarios