<Tabs
  defaultValue="linux"
  values={[
    {label: 'Linux', value: 'linux'},
    {label: 'Mac', value: 'mac'},
    {label: 'Windows', value: 'windows'}
  ]}>

<TabItem value="linux">

| Category                      | Prerequisites                                                |
| :---------------------------- | :----------------------------------------------------------- |
| Linux distribution            | Anything recent enough, e.g. Ubuntu 20.04                    |
| Python                        | 3.6+, with a usable pip(`python3-pip` package on Ubuntu)     |
| Clang++                       | Clang++ &gt;= 10, Clang++ 15 is recommended.                 |
| libstdc++-xx-dev              | Run `apt install libstdc++-10-dev`, or just install `g++`.   |

</TabItem>

<TabItem value="mac">

| Category                       | Prerequisites                            |
| :----------------------------- | ---------------------------------------- |
| macOS                          | macOS Big Sur or later                   |
| Python                         | 3.6+ (should be readily available)       |
| Command line tools for Xcode   | Run `xcode-select --install` to install  |

</TabItem>

<TabItem value="windows">

| Category        | Prerequisites                                                                   |
| :-------------- | ------------------------------------------------------------------------------- |
| Windows         | Windows 7/8/10/11                                                               |
| Python          | 3.6+                                                                            |
| Visual Studio   | Visual Studio 2022 (any edition) with "Desktop Development with C++" component. |

</TabItem>

</Tabs>

<Tabs
  defaultValue="linux"
  values={[
    {label: 'Linux & macOS', value: 'linux'},
    {label: 'Windows', value: 'windows'},
  ]}>

<TabItem value="linux">

```shell
wget https://github.com/llvm/llvm-project/archive/refs/tags/llvmorg-15.0.5.tar.gz

tar zxvf llvmorg-15.0.5.tar.gz

cd llvm-project-llvmorg-15.0.5/llvm

mkdir build

cd build

cmake .. -DLLVM_ENABLE_RTTI:BOOL=ON -DBUILD_SHARED_LIBS:BOOL=OFF -DCMAKE_BUILD_TYPE=Release -DLLVM_TARGETS_TO_BUILD="X86;NVPTX" -DLLVM_ENABLE_ASSERTIONS=ON -DLLVM_ENABLE_TERMINFO=OFF

# If you are building on Apple M1, use -DLLVM_TARGETS_TO_BUILD="AArch64".

# If you are building on NVIDIA Jetson TX2, use -DLLVM_TARGETS_TO_BUILD="ARM;NVPTX"

# If you are building for a PyPI release, add -DLLVM_ENABLE_Z3_SOLVER=OFF to reduce the library dependency.

make -j 8

sudo make install

# Check your LLVM installation

llvm-config --version  # You should get 15.0.5
```

</TabItem>

<TabItem value="windows">

```shell
# For Windows

# LLVM 15.0.0 + MSVC 2019

cmake .. -G "Visual Studio 16 2019" -A x64 -DLLVM_ENABLE_RTTI:BOOL=ON -DBUILD_SHARED_LIBS:BOOL=OFF -DCMAKE_BUILD_TYPE=Release -DLLVM_TARGETS_TO_BUILD="X86;NVPTX" -DLLVM_ENABLE_ASSERTIONS=ON -Thost=x64 -DLLVM_BUILD_TESTS:BOOL=OFF -DCMAKE_INSTALL_PREFIX=installed -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL -DCMAKE_CXX_STANDARD=17
cmake --build . --target=INSTALL --config=Release
```

1. Use Visual Studio 2017+ to build **LLVM.sln**.
2. Ensure that you use the **Release** configuration. After building the `INSTALL` project (under folder **CMakePredefinedTargets** in the Solution Explorer window).
3. If you use MSVC 2019+, ensure that you use **C++17** for the `INSTALL` project.
4. When the build completes, add an environment variable `LLVM_DIR` with value `<PATH_TO_BUILD>/build/installed/lib/cmake/llvm`.

</TabItem>

</Tabs>

To actually use the compiled LLVM binaries, replace the LLVM folder in the cache directory of `build.py` (open with `./build.py cache`) with your own version.

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

<Tabs
  defaultValue="ubuntu"
  values={[
    {label: 'Ubuntu', value: 'ubuntu'},
    {label: 'Arch Linux', value: 'arch'},
    {label: 'Windows', value: 'windows'},
  ]}>

<TabItem value="ubuntu">

1. Go to [the official site](https://developer.nvidia.com/cuda-downloads) to download the installer.
2. Choose **deb (local)** as **Installer Type**.
3. Check if CUDA is properly installed:

  ```
  nvidia-smi
  ```

</TabItem>

<TabItem value="arch">

1. `pacman -S cuda`
2. Check if CUDA is properly installed:

  ```
  nvidia-smi
  ```

</TabItem>

<TabItem value="windows">

1. Go to [the official site](https://developer.nvidia.com/cuda-downloads) and download the installer.
2. Choose **exe (local)** as **Installer Type**.
3. Check if CUDA is properly installed:

  ```
  nvidia-smi
  ```

</TabItem>

</Tabs>

<Tabs
  defaultValue="linux"
  values={[
    {label: 'Linux', value: 'linux'},
    {label: 'Windows', value: 'windows'},
]}>

<TabItem value="linux">

1. Ensure that you have a Vulkan driver from a GPU vendor properly installed.

  > On Ubuntu, check if a JSON file with a name corresponding to your GPU vendor is in: `/etc/vulkan/icd.d/` or `/usr/share/vulkan/icd.d/`.

2. Add an environment variable `TAICHI_CMAKE_ARGS` with the value `-DTI_WITH_VULKAN:BOOL=ON` to enable the Vulkan backend: (Otherwise Vulkan backend is disabled by default when compiling from source, and `build.py` won't setup Vulkan SDK for you).

  ```shell
  export TAICHI_CMAKE_ARGS="$TAICHI_CMAKE_ARGS -DTI_WITH_VULKAN:BOOL=ON"
  ```

3. Check if the SDK is properly installed: Run `vulkaninfo` in the build shell:

    ```shell
    ./build.py --shell
    vulkaninfo
    ```

</TabItem>

<TabItem value="windows">

1. Add an environment variable `TAICHI_CMAKE_ARGS` with the value `-DTI_WITH_VULKAN:BOOL=ON` to enable the Vulkan backend: (Otherwise Vulkan backend is disabled by default when compiling from source, and `build.py` won't setup Vulkan SDK for you).

    ```pwsh
    $env:TAICHI_CMAKE_ARGS += " -DTI_WITH_VULKAN:BOOL=ON"
    ```

2. Check if the SDK is properly installed: Run `vulkaninfo` in the build shell:

    ```pwsh
    python ./build.py --shell
    vulkaninfo
    ```


</TabItem>

</Tabs>

<Tabs
  defaultValue="linux"
  values={[
    {label: 'Linux & macOS', value: 'linux'},
    {label: 'Windows', value: 'windows'},
  ]}>

<TabItem value="linux">

  ```shell
  git clone --recursive https://github.com/taichi-dev/taichi

  cd taichi

  # Customize with your own needs
  export TAICHI_CMAKE_ARGS="-DTI_WITH_VULKAN:BOOL=ON -DTI_WITH_CUDA:BOOL=ON"

  # Uncomment if you want to use a different compiler
  # export CC=/path/to/clang
  # export CXX=/path/to/clang++

  # export DEBUG=1 # Uncomment it if you wish to keep debug information.

  # This would drop into a shell with complete build environment,
  ./build.py --shell

  # and then you could install Taichi in development mode
  python3 setup.py develop
  ```
</TabItem>

<TabItem value="windows">

  ```shell
  git clone --recursive https://github.com/taichi-dev/taichi

  cd taichi

  # Customize with your own needs
  $env:TAICHI_CMAKE_ARGS += " -DTI_WITH_VULKAN:BOOL=ON -DTI_WITH_CUDA:BOOL=ON"

  # $env:DEBUG = 1 # Uncomment it if you wish to keep debug information.

  # This would drop into a shell with complete build environment,
  ./build.py --shell
  # and then you could install Taichi in development mode
  python3 setup.py develop
  ```

</TabItem>

</Tabs>

./build.py
ls dist/*.whl

python3 python/taichi/examples/simulation/mpm128.py

./build.py cache

# Build a wheel
./build.py --python=3.10

# Or enter development shell
./build.py --python=3.10 --shell

# Use your own conda
conda activate my-own-conda-env

# Build a wheel
./build.py --python=native

# Or enter development shell
./build.py --python=native --shell

./build.py --shell

python3 setup.py clean