Metadata-Version: 2.4
Name: trace-agent-server
Version: 0.0.3
Summary: TraceAgent FastAPI backend server.
Author-email: Enrique Javier Villar Cea <villarcea.enriquejavier@gmail.com>, Javier Rodriguez Castellano <javirodriguezcastellano@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/LixusSoftware/TraceAgent
Project-URL: Repository, https://github.com/LixusSoftware/TraceAgent
Project-URL: Issues, https://github.com/LixusSoftware/TraceAgent/issues
Keywords: agent,observability,tracing,llm,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: trace-agent-sdk
Requires-Dist: fastapi<1.0.0,>=0.115.0
Requires-Dist: httpx<1.0.0,>=0.27.0
Requires-Dist: openai<2.0.0,>=1.52.0
Requires-Dist: pydantic<3.0.0,>=2.8.0
Requires-Dist: pydantic-settings<3.0.0,>=2.3.0
Requires-Dist: sqlalchemy<3.0.0,>=2.0.32
Requires-Dist: uvicorn[standard]<1.0.0,>=0.30.0
Provides-Extra: dev
Requires-Dist: pytest<9.0.0,>=8.3.2; extra == "dev"
Requires-Dist: pytest-cov<7.0.0,>=6.0.0; extra == "dev"
Provides-Extra: providers
Requires-Dist: anthropic>=0.42.0; extra == "providers"
Requires-Dist: google-generativeai>=0.8.0; extra == "providers"
Provides-Extra: langchain
Requires-Dist: trace-agent-langchain; extra == "langchain"

# TraceAgent Server

![GitHub Release](https://img.shields.io/github/v/release/LixusSoftware/TraceAgent)
![GitHub Stars](https://img.shields.io/github/stars/LixusSoftware/TraceAgent)
![GitHub License](https://img.shields.io/github/license/LixusSoftware/TraceAgent)
![Tests](https://github.com/LixusSoftware/TraceAgent/actions/workflows/test.yml/badge.svg)
![Docker Build](https://github.com/LixusSoftware/TraceAgent/actions/workflows/build-docker.yml/badge.svg)

FastAPI backend for TraceAgent. Stores runs, generates timelines, execution graphs, and explanations.

## Install

```bash
pip install trace-agent-server[providers]
```

## Run

```bash
# With the included CLI
trace-agent-server --host 0.0.0.0 --port 8000

# Or directly with uvicorn
uvicorn trace_agent_server.main:app --reload
```

## Environment variables

| Variable | Default | Description |
|----------|---------|-------------|
| `TRACE_AGENT_DATABASE_URL` | `sqlite:///./trace_agent.db` | Database URL (SQLite or PostgreSQL) |
| `TRACE_AGENT_OPENAI_API_KEY` | - | OpenAI API key |
| `TRACE_AGENT_OPENAI_BASE_URL` | - | OpenAI-compatible base URL (e.g. LM Studio) |
| `TRACE_AGENT_AUDIT_ENABLE_GUARDRAILS` | `false` | Enable prompt injection and PII checks |
| `TRACE_AGENT_AUDIT_METRICS_ENABLED` | `true` | Expose Prometheus `/metrics` endpoint |

## License

MIT
