TIRx Harness
An Open Compiler Harness for Agentic GPU Programming
Get Started | Documentation | Book | Blogpost
Overview
TIRx Harness is a compiler harness combining a minimal stable compiler foundation, a knowledge base, tools, and a benchmark server to help agents develop correct, fast GPU kernels.
TIRx Harness brings together:
- tirx-lite for kernel authoring: a domain-specific language over the TIRx intermediate representation.
- Compiler analysis: check synchronization, memory races, and numerical behavior; inspect compiler output and generated GPU instructions.
- kcoral for remote execution: keep your agent on one machine and run GPU work on another.
Skills guide the agent in using them, while workload contracts define correctness and performance.
Get Started
Install the released package from PyPI:
python -m pip install tirx-harness
To develop the harness, follow Build from source for the build prerequisites, repository checkout, and native submodule setup.
See the documentation for details:
- Installation: prerequisites, other installation methods, and agent skills
- Quick Start: optimize a kernel in your own project
- Optimization Runs: run a registered workload
The book Agentic GPU Programming for MLSys explains the design behind the harness and walks through an optimization workflow.
Contributing
- Add a workload: define a new optimization task
- Contribute a kernel: publish a kernel produced by a run
- Report and fix bugs: reproduce and resolve a defect
Release files for tirx-harness 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tirx_harness-0.1.2.tar.gz | 13.7 MB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tirx_harness-0.1.2-cp312-abi3-manylinux_2_28_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| tirx_harness-0.1.2-cp312-abi3-manylinux_2_28_aarch64.whl | CPython 3.12 | abi3 | Linux glibc 2.28+ ARM64 | Details |
Total release size: 24.6 MB
Release files / tirx_harness-0.1.2.tar.gz
| Download URL | tirx_harness-0.1.2.tar.gz |
|---|---|
| Size | 13.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1a8024e628f396ecad85567aab54b27aca02c0b21007c70aa139ad7cd5555633
|
|
BLAKE2b-256 checksum How to use checksums |
375837d75c99d1dace2c407cda9df5ec48bb565d4cf5178f9df63715ea129151
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tirx_harness-0.1.2-cp312-abi3-manylinux_2_28_x86_64.whl
| Download URL | tirx_harness-0.1.2-cp312-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
271360b99a8a23d2a54389fc3d26df2b5966164305aaa049baa7681e109d28c2
|
|
BLAKE2b-256 checksum How to use checksums |
aa4f09c026410b8931f8be58806a59eda7087ac818550137a58bee99141cafbf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / tirx_harness-0.1.2-cp312-abi3-manylinux_2_28_aarch64.whl
| Download URL | tirx_harness-0.1.2-cp312-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 5.4 MB |
| Tags | CPython 3.12 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
c3499586f9f74c9d0edd0df9f35b0b39401de7c17856c37b01c9ffafdcae73d2
|
|
BLAKE2b-256 checksum How to use checksums |
2295e0ec03f9691a7bfccd22aeb9c80a69f2a48442cc7707818df1a9df507350
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
