This release is a pre-release and may not be stable for production use.
TritonParse
A comprehensive visualization and analysis tool for Triton kernel compilation and launch — helping developers analyze, debug, and understand Triton kernel compilation processes.
✨ Key Features
- 🚀 Launch Difference Analysis - Automatically detect and visualize variations in kernel launch parameters, helping you pinpoint performance bottlenecks and debug launch configurations.
- 🔍 Interactive Visualization - Explore Triton kernels with detailed metadata and stack traces
- 📊 Multi-format IR Support - View TTGIR, TTIR, LLIR, PTX, and AMDGCN in one place
- 🔄 Side-by-side Comparison - Compare IR stages with synchronized highlighting
- 📝 Structured Logging - Capture detailed compilation and launch events with source mapping
- 🌐 Ready-to-use Interface - No installation required, works in your browser
- 🔒 Privacy-first - All processing happens locally in your browser, no data uploaded
🚀 Quick Start
1. Generate Traces
import tritonparse.structured_logging
# Initialize logging with launch tracing enabled
tritonparse.structured_logging.init("./logs/", enable_trace_launch=True)
# Your Triton/PyTorch code here
# ... your kernels ...
# Parse and generate trace files
import tritonparse.utils
tritonparse.utils.unified_parse("./logs/")
The example terminal output is:
tritonparse log file list: /tmp/tmp1gan7zky/log_file_list.json
INFO:tritonparse:Copying parsed logs from /tmp/tmp1gan7zky to /scratch/findhao/tritonparse/tests/parsed_output
================================================================================
📁 TRITONPARSE PARSING RESULTS
================================================================================
📂 Parsed files directory: /scratch/findhao/tritonparse/tests/parsed_output
📊 Total files generated: 2
📄 Generated files:
--------------------------------------------------
1. 📝 dedicated_log_triton_trace_findhao__mapped.ndjson.gz (7.2KB)
2. 📝 log_file_list.json (181B)
================================================================================
✅ Parsing completed successfully!
================================================================================
2. Visualize Results
Visit https://meta-pytorch.org/tritonparse/ and open your local trace files (.ndjson.gz format).
🔒 Privacy Note: Your trace files are processed entirely in your browser - nothing is uploaded to any server!
🛠️ Installation
For basic usage (trace generation): Four options:
# install nightly version
pip install -U --pre tritonparse
# install stable version
pip install tritonparse
# install from source
git clone https://github.com/meta-pytorch/tritonparse.git
cd tritonparse
pip install -e .
# pip install the latest version from github
pip install git+https://github.com/meta-pytorch/tritonparse.git
Prerequisites: Python ≥ 3.10, Triton ≥ 3.4.0, GPU required (NVIDIA/AMD)
TritonParse relies on new features in Triton. Please install the latest version of Triton:
pip install triton
📚 Complete Documentation
| 📖 Guide | Description |
|---|---|
| 🏠 Wiki Home | Complete documentation and navigation |
| 📦 Installation Guide | Detailed setup for all scenarios |
| 📋 Usage Guide | Complete workflow and examples |
| 🌐 Web Interface Guide | Master the visualization interface |
| 🔧 Developer Guide | Contributing and development setup |
| ❓ FAQ | Frequently asked questions |
🛠️ Tech Stack
- Frontend: React 19, TypeScript, Vite, Tailwind CSS, Monaco Editor
- Backend: Python with Triton integration, structured logging
- Deployment: GitHub Pages, automatic deployment
📊 Understanding Triton Compilation
TritonParse visualizes the complete Triton compilation pipeline:
Python Source → TTIR → TTGIR → LLIR → PTX/AMDGCN
Each stage can be inspected and compared to understand optimization transformations.
🤝 Contributing
We welcome contributions! Please see our Developer Guide for:
- Development setup
- Code formatting standards
- Pull request process
- Architecture overview
📞 Support & Community
- 🐛 Report Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
- 📚 Documentation: TritonParse Wiki
📄 License
This project is licensed under the BSD-3 License - see the LICENSE file for details.
✨ Ready to get started? Visit our Installation Guide or try the online tool directly!
1 maintainer
Release files for tritonparse 0.2.4.dev20250929071529
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tritonparse-0.2.4.dev20250929071529.tar.gz | 2.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tritonparse-0.2.4.dev20250929071529-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.7 MB
Release files / tritonparse-0.2.4.dev20250929071529.tar.gz
| Download URL | tritonparse-0.2.4.dev20250929071529.tar.gz |
|---|---|
| Size | 2.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
302ee84c1581a14c988e4e52d244f60812a3d1700596903fd24ba22f7061dc6e
|
|
BLAKE2b-256 checksum How to use checksums |
d2ecdc041d29b1f7891a3054fc2388eb217bbe830f1fca53f494ea8ae4dba84a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / tritonparse-0.2.4.dev20250929071529-py3-none-any.whl
| Download URL | tritonparse-0.2.4.dev20250929071529-py3-none-any.whl |
|---|---|
| Size | 55.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bf36f34db982b19b1407f6fdf36e7c98cc9fba648dd670e614fc5c0a88511598
|
|
BLAKE2b-256 checksum How to use checksums |
9a840a60f2105ce9b8c4f6cdf0813204d4e1ec3022000a1e2e90168c6399f787
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
