@@ -13,19 +13,19 @@ Helion currently targets Linux systems and requires a recent Python and PyTorch
1313- We recommend using [ uv] ( https://docs.astral.sh/uv/ ) for lightweight, fast virtual environments
1414
1515### Dependencies
16- - ** [ PyTorch] ( https://github.com/pytorch/pytorch ) nightly build **
17- - ** [ Triton] ( https://github.com/triton-lang/triton ) development version ** installed from source
16+ - ** [ PyTorch] ( https://github.com/pytorch/pytorch ) 2.9 or later **
17+ - ** [ Triton] ( https://github.com/triton-lang/triton ) 3.5 or later **
1818
1919 * Note: Older versions may work, but will lack support for features like TMA on Hopper/Blackwell GPUs and may exhibit lower performance.*
2020
2121## Installation Methods
2222
2323### Method 1: Install via pip
2424
25- The easiest way to install Helion is directly from GitHub :
25+ The easiest way to install Helion is from PyPI :
2626
2727``` bash
28- pip install git+https://github.com/pytorch/ helion.git
28+ pip install helion
2929```
3030
3131We also publish [ PyPI releases] ( https://pypi.org/project/helion/ ) , but the GitHub version is recommended for the latest features and fixes.
@@ -59,29 +59,54 @@ uv venv .venv
5959source .venv/bin/activate
6060```
6161
62- ### 2. Install PyTorch Nightly
62+ ### 2. Install PyTorch
6363
64- Install the latest PyTorch nightly build :
64+ Install PyTorch 2.9 or later :
6565
6666``` bash
67- # For CUDA 12.6 systems
68- pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu126
67+ # CUDA 12.8
68+ pip install " torch==2.9.*" --index-url https://download.pytorch.org/whl/cu128
69+
70+ # ROCm 7.0
71+ pip install " torch==2.9.*" --index-url https://download.pytorch.org/whl/rocm7.0
6972```
7073see [ PyTorch installation instructions] ( https://pytorch.org/get-started/locally/ ) for other options.
7174
72- ### 3. Install Triton from Source
75+ ### 3. Install Triton
76+
77+ Install Triton 3.5 or later using one of the options below.
7378
74- Helion requires a development version of Triton:
79+ #### Option A: Prebuilt wheel (recommended)
7580
7681``` bash
82+ # Install Triton from PyPI (will pick the right wheel for your platform if available)
83+ pip install " triton>=3.5"
84+
85+ # Verify
86+ python -c " import triton; print('Triton version:', triton.__version__)"
87+ ```
88+
89+ If a suitable wheel is not available for your platform, build from source:
90+
91+ #### Option B: Build from source (Ubuntu/Debian)
92+
93+ ``` bash
94+ # Install build dependencies (adjust versions as needed)
95+ sudo apt-get update
96+ sudo apt-get install -y git clang-14 clang++-14 zlib1g-dev python3-dev
97+
98+ # (Optional) set compilers explicitly
99+ export CC=clang-14
100+ export CXX=clang++-14
101+
77102# Clone and install Triton
78103git clone https://github.com/triton-lang/triton.git
79104cd triton
105+ pip install -r python/requirements.txt
106+ MAX_JOBS=$( nproc) TRITON_PARALLEL_LINK_JOBS=2 pip install .
80107
81- # Install Triton
82- pip install -e .
83-
84- # Return to your working directory
108+ # Verify and clean up
109+ python -c " import triton; print('Triton version:', triton.__version__)"
85110cd ..
86111```
87112
@@ -90,10 +115,10 @@ cd ..
90115Choose one of the installation methods above:
91116
92117``` bash
93- # Option A: From GitHub
94- pip install git+https://github.com/pytorch/ helion.git
118+ # From PyPI
119+ pip install helion
95120
96- # Option B: Development installation
121+ # Development installation
97122git clone https://github.com/pytorch/helion.git
98123cd helion
99124pip install -e ' .[dev]'
0 commit comments