安装 Taichi

通过 pip 可以很容易安装 Taichi :

  1. python3 -m pip install taichi

注解

目前，Taichi 支持的 Python 版本有 3.6/3.7/3.8 (64-bit)。

  • 对于Ubuntu 19.04+，请执行 sudo apt install libtinfo5 安装依赖项。
  • 对于Arch Linux，请执行 yaourt -S ncurses5-compat-libs 安装依赖项。
  • 对于 Windows，请预先安装运行组件库 Microsoft Visual C++ Redistributable .

故障排除

Windows 相关问题

Python 相关问题

  • 如果 pip 报错找不到合适的包，即,

    1. ERROR: Could not find a version that satisfies the requirement taichi (from versions: none)
    2. ERROR: No matching distribution found for taichi

    • 确保你使用的 Python 版本是 3.6/3.7/3.8:

      1. python3 -c “print(__import__(‘sys’).version[:3])”
      2. # 3.6, 3.7 或 3.8

    • 确保你安装的 Python 可执行文件是 64-bit:

      1. python3 -c "print(__import__('platform').architecture()[0])"
      2. # 64bit

CUDA 相关问题

  • 如果 Taichi 报告以下崩溃信息:

    1. [Taichi] mode=release
    2. [Taichi] version 0.6.0, supported archs: [cpu, cuda, opengl], commit 14094f25, python 3.8.2
    3. [W 05/14/20 10:46:49.549] [cuda_driver.h:call_with_warning@60] CUDA Error CUDA_ERROR_INVALID_DEVICE: invalid device ordinal while calling mem_advise (cuMemAdvise)
    4. [E 05/14/20 10:46:49.911] Received signal 7 (Bus error)

    这可能是因为你使用的 NVIDIA GPU 低于 Pascal 架构，这对 统一内存 (Unified Memory) 会有限制。

    • 解决方案: 尝试添加 export TI_USE_UNIFIED_MEMORY=0 到 ~/.bashrc 。该操作将禁用CUDA后端使用统一内存。

  • 如果你遇到了其他 CUDA 相关问题，不要气馁:

    • 解决方案:尝试添加 export TI_ENABLE_CUDA=0 到 ~/.bashrc 。该操作将完全禁用CUDA后端，这样Taichi会依赖于其他GPU后端，如OpenGL。

OpenGL 相关问题

  • 针对 Taichi 打印出的调用栈回溯 (stack backtrace) 中包含 glfwCreateWindow 等信息的情况 (更详细的问题描述请对照 #958):

    1. [Taichi] mode=release
    2. [E 05/12/20 18.25:00.129] Received signal 11 (Segmentation Fault)
    3. ***********************************
    4. * Taichi Compiler Stack Traceback *
    5. ***********************************
    7. ... (many lines, omitted)
    9. /lib/python3.8/site-packages/taichi/core/../lib/taichi_core.so: _glfwPlatformCreateWindow
    10. /lib/python3.8/site-packages/taichi/core/../lib/taichi_core.so: glfwCreateWindow
    11. /lib/python3.8/site-packages/taichi/core/../lib/taichi_core.so: taichi::lang::opengl::initialize_opengl(bool)
    13. ... (many lines, omitted)

    这很可能是因为你运行 Taichi 的虚拟机上的 OpenGL 版本过低。Taichi 需要 OpenGL 4.3+ 才能工作。

    • 解决方案: 尝试添加 export TI_ENABLE_OPENGL=0 到 ~/.bashrc 。该操作将禁用OpenGL后端检测，以避免OpenGL版本不兼容的问题。

Linux 相关问题

  • 如果 Taichi 崩溃并报告错误 libtinfo.so.5 not found:

    • 对于 Ubuntu ，请执行 sudo apt install libtinfo-dev 安装依赖项。

    • 对于 Arch Linux ，请首先编辑 /etc/pacman.conf，添加以下代码:

      1. [archlinuxcn]
      2. Server = https://mirrors.tuna.tsinghua.edu.cn/archlinuxcn/$arch

      随后执行 sudo pacman -Syy ncurses5-compat-libs 安装依赖项。

  • 如果 Taichi 崩溃并报告 /usr/lib/libstdc++.so.6: version `CXXABI_1.3.11’ not found:

    你可能正在使用 Ubuntu 16.04 ，请根据 这个帖子 中的解决方案尝试解决：

    1. sudo add-apt-repository ppa:ubuntu-toolchain-r/test -y
    2. sudo apt-get update
    3. sudo apt-get install libstdc++6

其他相关问题

  • 如果以上都没能解决你的问题，请在 GitHub 上 开个 issue 进行报告。这将帮助我们后续提高用户体验和兼容性，非常感谢！