Metadata-Version: 2.4
Name: tracepanel-agent
Version: 0.0.1a2
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Rust
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: System :: Monitoring
License-File: LICENSE
License-File: NOTICE
License-File: THIRD-PARTY-NOTICES
Summary: The Tracepanel agent: keeps your app's traces and logs, finds N+1 queries and other issues, serves the local console
Keywords: debug toolbar,tracing,n+1,sql,django,fastapi,flask,observability
License-Expression: FSL-1.1-ALv2
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/tracepanel/tracepanel
Project-URL: Issues, https://github.com/tracepanel/tracepanel/issues
Project-URL: Repository, https://github.com/tracepanel/tracepanel

# tracepanel-agent

The agent of [Tracepanel](https://github.com/tracepanel/tracepanel), which
collects the traces and logs of your app on your machine. It receives every
request, job and command with its SQL queries, Redis commands, cache calls,
outgoing HTTP calls and log lines. It finds N+1 queries and calls, duplicates,
slow SQL and slow HTTP calls, long transactions and errors, keeps everything in
your project's `.tracepanel/` directory, and serves the panel and the console.

You don't install it yourself. The Tracepanel SDKs bring it (for Python,
`pip install tracepanel`), and the first traced request starts it. To run the
agent by hand, with the console on http://127.0.0.1:8765/:

```bash
tracepanel-agent --serve 127.0.0.1:8765
```

It gives AI coding agents your traces over MCP too: `tracepanel-agent mcp`.

Your traces stay on your machine.

The agent is free to use on your projects, at work or on your own. It is fair
source, under the Functional Source License (FSL-1.1-ALv2). Use it, change it
and share your changes. The one thing it reserves is offering Tracepanel itself
as a commercial product or hosted service. Each version becomes Apache License
2.0 two years after its release.

