2f80a98776
Recently there has been more and more report about installation issues:
- Installing Triton before upgrading pytorch can create some issues because Triton uses some torch headers
- llvm-10-dev not available on some platform; llvm-11-dev not available on e.g. Ubuntu.
absence of nightly builds
This PR should fix all these issues. Some CMake tricks are used to download and install llvm at build time. Triton Python bindings were modified to remove dependence on pytorch ops. Midnight CI job added to generate binary wheels for all Triton version and update them on pypi's new triton-nightly project.
This PR will also make it very easy to use LLVM forks in the future for whatever needs we have.
62 lines
1.4 KiB
ReStructuredText
62 lines
1.4 KiB
ReStructuredText
==============
|
|
Installation
|
|
==============
|
|
|
|
---------------------
|
|
Binary Distributions
|
|
---------------------
|
|
|
|
You can install the latest nightly release of Triton from pip:
|
|
|
|
.. code-block:: bash
|
|
|
|
pip install triton-nightly
|
|
|
|
|
|
--------------
|
|
From Source
|
|
--------------
|
|
|
|
+++++++++++++++
|
|
Python Package
|
|
+++++++++++++++
|
|
|
|
You can install the Python package from source by running the following commands:
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone https://github.com/ptillet/triton.git;
|
|
cd triton/python;
|
|
pip install -e .
|
|
|
|
This may take a while (10-20 minutes) as it will download and compile LLVM from source.
|
|
|
|
You can then test your installation by running the unit tests:
|
|
|
|
.. code-block:: bash
|
|
|
|
pytest -vs .
|
|
|
|
and the benchmarks
|
|
|
|
.. code-block:: bash
|
|
|
|
cd bench/
|
|
python -m run --with-plots --result-dir /tmp/triton-bench
|
|
|
|
+++++++++++++++
|
|
C++ Package
|
|
+++++++++++++++
|
|
|
|
Those not interested in Python integration may want to use the internals of Triton (i.e, runtime, parser, codegen, driver, intermediate representation) directly. This can be done by running the following commands:
|
|
|
|
.. code-block:: bash
|
|
|
|
git clone https://github.com/ptillet/triton.git;
|
|
mkdir build;
|
|
cd build;
|
|
cmake ../;
|
|
make -j8;
|
|
|
|
Note that while direct usage of the C++ API is not officially supported, a usage tutorial can be found `here <https://github.com/ptillet/triton/blob/master/tutorials/01-matmul.cc>`_
|