Skip to main content

The Taichi Programming Language

Project description


Latest Release downloads CI Nightly Release Python Codecov Status

import taichi as ti

What is Taichi Lang?

Taichi Lang is an open-source, imperative, parallel programming language for high-performance numerical computation. It is embedded in Python and uses just-in-time (JIT) compiler frameworks, for example LLVM, to offload the compute-intensive Python code to the native GPU or CPU instructions.

The language has broad applications spanning real-time physical simulation, numberical computation, augmented reality, artificial intelligence, vision and robotics, visual effects in films and games, general-purpose computing, and much more.

...More

Why Taichi Lang?

  • Built around Python: Taichi Lang shares almost the same syntax with Python, allowing you to write algorithms with minimal language barrier. It is also well integrated into the Python ecosystem, including NumPy and PyTorch.
  • Flexibility: Taichi Lang provides a set of generic data containers known as SNode (/ˈsnoʊd/), an effective mechanism for composing hierarchical, multi-dimensional fields. This can cover many use patterns in numerical simulation (e.g. spatially sparse computing).
  • Performance: With the @ti.kernel decorator, Taichi Lang's JIT compiler automatically compiles your Python functions into efficient GPU or CPU machine code for parallel execution.
  • Portability: Write your code once and run it everywhere. Currently, Taichi Lang supports most mainstream GPU APIs, such as CUDA and Vulkan.
  • ... and many more features! A cross-platform, Vulkan-based 3D visualizer, differentiable programming, quantized computation (experimental), etc.

Getting Started

Installation

Prerequisites
  • Operating systems
    • Windows
    • Linux
    • macOS
  • Python: 3.6 ~ 3.10 (64-bit only)
  • Compute backends
    • x64/ARM CPUs
    • CUDA
    • Vulkan
    • OpenGL (4.3+)
    • Apple Metal
    • WebAssembly (experiemental)

Use Python's package installer pip to install Taichi Lang:

pip install --upgrade taichi

We also provide a nightly package. Note that nighly packages may crash because they are not fully tested. We cannot guarantee their validity, and you are at your own risk trying out our latest, untested features. The nightly packages can be installed from our self-hosted PyPI (Using self-hosted PyPI allows us to provide more frequent releases over a longer period of time)

pip install -i https://pypi.taichi.graphics/simple/ taichi-nightly

Run your "Hello, world!"

Here is how you can program a 2D fractal in Taichi:

# python/taichi/examples/simulation/fractal.py

import taichi as ti

ti.init(arch=ti.gpu)

n = 320
pixels = ti.field(dtype=float, shape=(n * 2, n))


@ti.func
def complex_sqr(z):
    return ti.Vector([z[0]**2 - z[1]**2, z[1] * z[0] * 2])


@ti.kernel
def paint(t: float):
    for i, j in pixels:  # Parallelized over all pixels
        c = ti.Vector([-0.8, ti.cos(t) * 0.2])
        z = ti.Vector([i / n - 1, j / n - 0.5]) * 2
        iterations = 0
        while z.norm() < 20 and iterations < 50:
            z = complex_sqr(z) + c
            iterations += 1
        pixels[i, j] = 1 - iterations * 0.02


gui = ti.GUI("Julia Set", res=(n * 2, n))

for i in range(1000000):
    paint(i * 0.03)
    gui.set_image(pixels)
    gui.show()

If Taichi Lang is properly installed, you should get the animation below 🎉:

See Get started for more information.

Build from source

If you wish to try our our experimental features or build Taichi Lang for your own environments, see Developer installation.

Documentation

Contributing

Kudos to all of our amazing contributors! Taichi Lang thrives through open-source. In that spirit, we welcome all kinds of contributions from the community. If you would like to participate, check out the Contribution Guidelines first.

Contributor avatars are randomly shuffled.

License

Taichi Lang is distributed under the terms of Apache License (Version 2.0).

See Apache License for details.

Community

Event

Voxel Challenge 2022 is open for submissions until 18th May. Find out more here.

Join our discussions

Report an issue

Contact us

Reference

Demos

Lectures & talks

Citations

If you use Taichi Lang in your research, please cite the corresponding papers:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

taichi-1.0.3-cp310-cp310-win_amd64.whl (18.5 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

taichi-1.0.3-cp310-cp310-manylinux_2_27_x86_64.whl (28.2 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.27+ x86-64

taichi-1.0.3-cp310-cp310-manylinux2014_x86_64.whl (26.3 MB view hashes)

Uploaded CPython 3.10

taichi-1.0.3-cp310-cp310-macosx_11_0_arm64.whl (23.6 MB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

taichi-1.0.3-cp310-cp310-macosx_10_15_x86_64.whl (27.9 MB view hashes)

Uploaded CPython 3.10 macOS 10.15+ x86-64

taichi-1.0.3-cp310-cp310-macosx_10_14_x86_64.whl (24.0 MB view hashes)

Uploaded CPython 3.10 macOS 10.14+ x86-64

taichi-1.0.3-cp39-cp39-win_amd64.whl (18.5 MB view hashes)

Uploaded CPython 3.9 Windows x86-64

taichi-1.0.3-cp39-cp39-manylinux_2_27_x86_64.whl (28.2 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.27+ x86-64

taichi-1.0.3-cp39-cp39-manylinux2014_x86_64.whl (26.3 MB view hashes)

Uploaded CPython 3.9

taichi-1.0.3-cp39-cp39-macosx_11_0_arm64.whl (23.6 MB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

taichi-1.0.3-cp39-cp39-macosx_10_15_x86_64.whl (27.9 MB view hashes)

Uploaded CPython 3.9 macOS 10.15+ x86-64

taichi-1.0.3-cp39-cp39-macosx_10_14_x86_64.whl (24.0 MB view hashes)

Uploaded CPython 3.9 macOS 10.14+ x86-64

taichi-1.0.3-cp38-cp38-win_amd64.whl (18.5 MB view hashes)

Uploaded CPython 3.8 Windows x86-64

taichi-1.0.3-cp38-cp38-manylinux_2_27_x86_64.whl (28.2 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.27+ x86-64

taichi-1.0.3-cp38-cp38-manylinux2014_x86_64.whl (26.3 MB view hashes)

Uploaded CPython 3.8

taichi-1.0.3-cp38-cp38-macosx_11_0_arm64.whl (23.6 MB view hashes)

Uploaded CPython 3.8 macOS 11.0+ ARM64

taichi-1.0.3-cp38-cp38-macosx_10_15_x86_64.whl (27.9 MB view hashes)

Uploaded CPython 3.8 macOS 10.15+ x86-64

taichi-1.0.3-cp38-cp38-macosx_10_14_x86_64.whl (24.0 MB view hashes)

Uploaded CPython 3.8 macOS 10.14+ x86-64

taichi-1.0.3-cp37-cp37m-win_amd64.whl (18.5 MB view hashes)

Uploaded CPython 3.7m Windows x86-64

taichi-1.0.3-cp37-cp37m-manylinux_2_27_x86_64.whl (28.2 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.27+ x86-64

taichi-1.0.3-cp37-cp37m-manylinux2014_x86_64.whl (26.3 MB view hashes)

Uploaded CPython 3.7m

taichi-1.0.3-cp37-cp37m-macosx_10_15_x86_64.whl (27.9 MB view hashes)

Uploaded CPython 3.7m macOS 10.15+ x86-64

taichi-1.0.3-cp37-cp37m-macosx_10_14_x86_64.whl (24.0 MB view hashes)

Uploaded CPython 3.7m macOS 10.14+ x86-64

taichi-1.0.3-cp36-cp36m-win_amd64.whl (18.5 MB view hashes)

Uploaded CPython 3.6m Windows x86-64

taichi-1.0.3-cp36-cp36m-manylinux_2_27_x86_64.whl (28.2 MB view hashes)

Uploaded CPython 3.6m manylinux: glibc 2.27+ x86-64

taichi-1.0.3-cp36-cp36m-manylinux2014_x86_64.whl (26.3 MB view hashes)

Uploaded CPython 3.6m

taichi-1.0.3-cp36-cp36m-macosx_10_15_x86_64.whl (27.9 MB view hashes)

Uploaded CPython 3.6m macOS 10.15+ x86-64

taichi-1.0.3-cp36-cp36m-macosx_10_14_x86_64.whl (24.0 MB view hashes)

Uploaded CPython 3.6m macOS 10.14+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page