Skip to content

Commit d83e97d

Browse files
authored
[Docs] Suggest PyTorch 2.9 or above (#859)
1 parent c6de202 commit d83e97d

File tree

2 files changed

+45
-20
lines changed

2 files changed

+45
-20
lines changed

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -303,8 +303,8 @@ Helion currently targets Linux systems and requires a recent Python and PyTorch
303303

304304
- Linux-based OS
305305
- Python 3.10–3.14
306-
- [PyTorch] nightly build
307-
- A development version of [Triton], installed from source
306+
- [PyTorch] 2.9 or later
307+
- [Triton] 3.5 or later
308308
*(Older versions may work, but will lack support for features like
309309
TMA on Hopper/Blackwell GPUs and may exhibit lower performance.)*
310310

@@ -320,7 +320,7 @@ install compatible versions of [PyTorch] and [Triton].
320320
Once your environment is set up, you can install Helion directly from GitHub:
321321

322322
```bash
323-
pip install git+https://github.com/pytorch/helion.git
323+
pip install helion
324324
```
325325

326326
Alternatively, you may install from source for development purposes. If using `uv`, create and activate a virtual environment first:

docs/installation.md

Lines changed: 42 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -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

3131
We 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
5959
source .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
```
7073
see [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
78103
git clone https://github.com/triton-lang/triton.git
79104
cd 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__)"
85110
cd ..
86111
```
87112

@@ -90,10 +115,10 @@ cd ..
90115
Choose 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
97122
git clone https://github.com/pytorch/helion.git
98123
cd helion
99124
pip install -e '.[dev]'

0 commit comments

Comments
 (0)