Skip to main content

What is Quadrants?

Quadrants is a high-performance multi-platform compiler for physics simulation being continuously developed by Genesis AI.

It is designed for large-scale physics simulation and robotics workloads. It compiles Python code into highly optimized parallel kernels that run on:

  • NVIDIA GPUs (CUDA)
  • Vulkan-compatible GPUs (SPIR-V)
  • Apple Metal GPUs
  • AMD GPUs (ROCm HIP)
  • x86 and ARM64 CPUs

The origin

The quadrants project was originally forked from Taichi in June 2025. As the original Taichi is no longer being maintained and the codebase evolved into a fully independent compiler with its own direction and long-term roadmap, we decided to give it a name that reflects both its roots and its new identity. The name Quadrants is inspired by the Chinese saying:

太极生两仪,两仪生四象

The Supreme Polarity (Taichi) gives rise to the Two Modes (Yin & Yang), which in turn give rise to the Four Forms (Quadrants).

Quadrants captures the idea of progression originated from taichi — built on the same foundation, evolving in its own direction while acknowledging its roots. This project is now fully independent and does not aim to maintain backward compatibility with upstream Taichi.

How Quadrants differs from upstream Taichi

While the repository still resembles upstream in structure, major changes include:

Platform support

  • LLVM 22, ARM (aarch64) support

CI

  • Kernel-level code coverage — device-side branch coverage in standard coverage.py format, integrated with pytest-cov
  • AI-driven checks for line wrapping, deleted comments, test coverage, and feature factorization

Structural improvements

  • dataclasses.dataclass structs — work with ndarrays and fields, nestable, passable to qd.func, zero kernel-runtime overhead
  • qd.Tensor — unified API over fields and ndarrays with per-tensor layout control, pickle support, and a backend= switch
  • BufferView — safe sub-range ndarray access with bounds checking in debug mode

Removed components

To focus the compiler and reduce maintenance burden, we removed: GUI/GGUI, C-API, AOT, DX11/DX12, iOS/Android, OpenGL/GLES, argpack, CLI, SourceBuilder.

Performance

  • Reduced launch latency — ndarray CPU performance improved 4.5×; ndarray GPU performance went from 11× slower than fields to ~30% slower (5090 GPU, Genesis benchmark)
  • Fastcache — opt-in source-level cache (@qd.kernel(fastcache=True)) that bypasses front-end AST parsing; reduces warm-cache kernel load from 7.2 s → 0.3 s on Genesis benchmarks
  • GPU Graphs - @qd.kernel(graph=True) captures kernel sequences into a graph; qd.graph.do_while runs GPU-side iteration loops (hardware conditional nodes on CUDA SM 9.0+)
  • perf_dispatch — auto-benchmarks multiple kernel implementations and selects the fastest at runtime
  • Zero-copy interop — to_torch(copy=False) / to_numpy(copy=False) via DLPack on CUDA, CPU, AMDGPU, and Metal; direct torch tensor pass-through into kernels

SIMT primitives

  • Tile16x16 / Tile32x32 — register-resident 16×16 and 32×32 matrix tiles with Cholesky, triangular solve, and rank-1 updates; 5× faster than shared-memory baselines on blocked linear algebra
  • Subgroup ops — cross-platform shuffle, shuffle_down, reduce_add, reduce_all_add across CUDA, AMDGPU, Metal and Vulkan

Autodiff

  • Autodiff with dynamic loops — computes the gradient of any kernel transparently using reverse-mode differentiation and runtime-based memory allocation
  • Forward-mode AD, custom gradients (@qd.ad.grad_replaced), qd.ad.Tape

Debugging & development


Installation

Prerequisites

  • Python 3.12-3.14
  • Mac OS 14, 15, Windows, or Ubuntu 22.04-24.04 or compatible
  • ROCm 5.2 or newer for AMD GPU support

Procedure

pip install quadrants

(For how to build from source, see our CI build scripts, e.g. linux build scripts )

Documentation

Something is broken!

Acknowledgements

Quadrants stands on the shoulders of the original Taichi project, built with care and vision by many contributors over the years. For the full list of contributors and credits, see the original Taichi repository.

We are grateful for that foundation.

Metadata

Release files for quadrants 1.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for quadrants 1.4.0
File Actions
quadrants-1.4.0-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for quadrants-1.4.0-cp314-cp314-win_amd64.whl
quadrants-1.4.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for quadrants-1.4.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
quadrants-1.4.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.34+ ARM64, Linux glibc 2.27+ ARM64 Details for quadrants-1.4.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
quadrants-1.4.0-cp314-cp314-macosx_13_0_arm64.whl CPython 3.14 CPython 3.14 macOS 13.0+ ARM64 Details for quadrants-1.4.0-cp314-cp314-macosx_13_0_arm64.whl
quadrants-1.4.0-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for quadrants-1.4.0-cp313-cp313-win_amd64.whl
quadrants-1.4.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for quadrants-1.4.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
quadrants-1.4.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.34+ ARM64, Linux glibc 2.27+ ARM64 Details for quadrants-1.4.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
quadrants-1.4.0-cp313-cp313-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 macOS 13.0+ ARM64 Details for quadrants-1.4.0-cp313-cp313-macosx_13_0_arm64.whl
quadrants-1.4.0-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for quadrants-1.4.0-cp312-cp312-win_amd64.whl
quadrants-1.4.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64, Linux glibc 2.27+ x86-64 Details for quadrants-1.4.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
quadrants-1.4.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl CPython 3.12 CPython 3.12 Linux glibc 2.27+ ARM64, Linux glibc 2.34+ ARM64 Details for quadrants-1.4.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
quadrants-1.4.0-cp312-cp312-macosx_13_0_arm64.whl CPython 3.12 CPython 3.12 macOS 13.0+ ARM64 Details for quadrants-1.4.0-cp312-cp312-macosx_13_0_arm64.whl

Total release size: 403.5 MB

Release files / quadrants-1.4.0-cp314-cp314-win_amd64.whl

Download URL quadrants-1.4.0-cp314-cp314-win_amd64.whl
Size 30.0 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
44ca07cb2253cec8173b39adeeebb262999a6bda4a7644f80f3fc5039670141a
BLAKE2b-256 checksum
How to use checksums
ea7645a34e8da5d99952f40b94b4d5fe77e5132c5f0e37f36b0787c79f6b31b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / quadrants-1.4.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 40.5 MB
Tags CPython 3.14 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
691120b10e101be20b2f5286a0aa31335ffda8d508d8d09100f2ddc69f4c3119
BLAKE2b-256 checksum
How to use checksums
044951ddaba3cdf6a494665867f36c1282786ff077950b16355a6125a3a01893
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / quadrants-1.4.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
Size 37.8 MB
Tags CPython 3.14 Linux glibc 2.27+ ARM64 Linux glibc 2.34+ ARM64
SHA-256 checksum
How to use checksums
37fce4bec0600ec764a3dc24cc54b197f6668c862fbad7369d48d593ac102d96
BLAKE2b-256 checksum
How to use checksums
168f1e9c3a0aec66f69b20bf8bdd5df2293d3361bd80300be7239958d6245eb0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / quadrants-1.4.0-cp314-cp314-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0-cp314-cp314-macosx_13_0_arm64.whl
Size 26.8 MB
Tags CPython 3.14 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
1ec1345e47a52c7ca864f32255c9c8738bb1c2eef6a409ec77c858784a85c7cf
BLAKE2b-256 checksum
How to use checksums
b042a512e6fd4c1745126b3f4d058b1ca7637a1e5f4f69e36c079be199fbbfc1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / quadrants-1.4.0-cp313-cp313-win_amd64.whl

Download URL quadrants-1.4.0-cp313-cp313-win_amd64.whl
Size 29.0 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
e459255b0ec96ff688882c8f25d422cb34830f43315c64e3e4d47791915e1f82
BLAKE2b-256 checksum
How to use checksums
35ae4933175102dfc88d8bcda7401399996e1cdf81b0c50ef539ed0b4a7e993f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / quadrants-1.4.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 40.5 MB
Tags CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
100b871b314c449f4f16af1d2e9070171994891c463c3b1a7928b7559f0c91e9
BLAKE2b-256 checksum
How to use checksums
329486d9c6aa2b462a461740f8f6949e747dc8f16b138100b7f4f183c7b004a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / quadrants-1.4.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
Size 37.8 MB
Tags CPython 3.13 Linux glibc 2.27+ ARM64 Linux glibc 2.34+ ARM64
SHA-256 checksum
How to use checksums
09b3bc83e7dcc0be607d07f791625d75ff6ef16be3088e9404e94903c0ad1bc9
BLAKE2b-256 checksum
How to use checksums
0d407cf29fdbb51cb36014ad609699ccb2319263ee284af8efef3985f385f9bb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / quadrants-1.4.0-cp313-cp313-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0-cp313-cp313-macosx_13_0_arm64.whl
Size 26.8 MB
Tags CPython 3.13 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
bda15cebb767dcf9546d292f9bb39b2a406c7fea4c4ac274d01f31c080c1092d
BLAKE2b-256 checksum
How to use checksums
b0ec92706db6c528b7509d63ea3763a05685f5cd38670f2459197622a50c20ab
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / quadrants-1.4.0-cp312-cp312-win_amd64.whl

Download URL quadrants-1.4.0-cp312-cp312-win_amd64.whl
Size 29.0 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
e9b9c0fa825451e6232b71ca93735553b4053d145a4102b67a95bedd805fba30
BLAKE2b-256 checksum
How to use checksums
8217d471ffc1c3732e13a03397880dcad50fe6bd1f5c74f6d6cb37c7920be623
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / quadrants-1.4.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 40.5 MB
Tags CPython 3.12 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
844d60aadcccd8947c8fd14c9fa25932ab2aaae37c0a52a54226b5e1cafeaac5
BLAKE2b-256 checksum
How to use checksums
c85f94990194d5864a8e93382e8489b9774c87aa6444c6e8f6e931823e1fe9a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / quadrants-1.4.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
Size 37.8 MB
Tags CPython 3.12 Linux glibc 2.27+ ARM64 Linux glibc 2.34+ ARM64
SHA-256 checksum
How to use checksums
f5d00f52f8fb47e17d1e6775fa63baeff782e6d81cfee922148da8c12af2ee04
BLAKE2b-256 checksum
How to use checksums
2f04e25360c433ccd185a4fde122a503bf9960996f62442d5d47ceec71a34b33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.15

Release files / quadrants-1.4.0-cp312-cp312-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0-cp312-cp312-macosx_13_0_arm64.whl
Size 26.8 MB
Tags CPython 3.12 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
51501939d9c37373a0cc1bca84904e2d42cbd4d264860ac1b9d5435a9f4529f8
BLAKE2b-256 checksum
How to use checksums
a77523eb8c90ffb44c8db081c56734d12032a911a4bed812c9930d7b92f005d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.15

Security for quadrants 1.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.4.0 This release

12 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page