Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.0b3

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.0b3
File Actions
quadrants-1.4.0b3-cp314-cp314-win_amd64.whl CPython 3.14 CPython 3.14 Windows x86-64 Details for quadrants-1.4.0b3-cp314-cp314-win_amd64.whl
quadrants-1.4.0b3-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for quadrants-1.4.0b3-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
quadrants-1.4.0b3-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl CPython 3.14 CPython 3.14 Linux glibc 2.27+ ARM64, Linux glibc 2.34+ ARM64 Details for quadrants-1.4.0b3-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
quadrants-1.4.0b3-cp314-cp314-macosx_13_0_arm64.whl CPython 3.14 CPython 3.14 macOS 13.0+ ARM64 Details for quadrants-1.4.0b3-cp314-cp314-macosx_13_0_arm64.whl
quadrants-1.4.0b3-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details for quadrants-1.4.0b3-cp313-cp313-win_amd64.whl
quadrants-1.4.0b3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for quadrants-1.4.0b3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
quadrants-1.4.0b3-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl CPython 3.13 CPython 3.13 Linux glibc 2.27+ ARM64, Linux glibc 2.34+ ARM64 Details for quadrants-1.4.0b3-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
quadrants-1.4.0b3-cp313-cp313-macosx_13_0_arm64.whl CPython 3.13 CPython 3.13 macOS 13.0+ ARM64 Details for quadrants-1.4.0b3-cp313-cp313-macosx_13_0_arm64.whl
quadrants-1.4.0b3-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details for quadrants-1.4.0b3-cp312-cp312-win_amd64.whl
quadrants-1.4.0b3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 Details for quadrants-1.4.0b3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
quadrants-1.4.0b3-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.0b3-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
quadrants-1.4.0b3-cp312-cp312-macosx_13_0_arm64.whl CPython 3.12 CPython 3.12 macOS 13.0+ ARM64 Details for quadrants-1.4.0b3-cp312-cp312-macosx_13_0_arm64.whl

Total release size: 403.5 MB

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

Download URL quadrants-1.4.0b3-cp314-cp314-win_amd64.whl
Size 30.0 MB
Tags CPython 3.14 Windows x86-64
SHA-256 checksum
How to use checksums
dcfe04467b84e49957cffd258e95307fa1bfc738d0bbfa00c25feea386b93e1e
BLAKE2b-256 checksum
How to use checksums
1f8d30820934564282b84a45ceedfb9000a9b52399eec05cd342f50a676f7ee7
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.0b3-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b3-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
aeb69ae2b62dc98978ff2bf774cea67e683960985bb84f295b152a3c30692d86
BLAKE2b-256 checksum
How to use checksums
d9b063da6eb6d2ccd19feba760d234563570f65b350d0022636a6dcfa62c783e
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.0b3-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b3-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
5874390004d44e645bcbdb01dbd8928b2e37b83981307be4e0fff8cb5e2b6228
BLAKE2b-256 checksum
How to use checksums
38a9fec2fa74eeb071e77d579d63942a42ac38d3472cfb2e936fa300ee6f1ee4
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.0b3-cp314-cp314-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b3-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
ee392c35bada792ad26bba47f1e36d256f17515093f9dafc3a640903e7247010
BLAKE2b-256 checksum
How to use checksums
5980b7335916b91e48face231e46b5595e8ca23f7158f2b69003b84fd5ea8a63
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.0b3-cp313-cp313-win_amd64.whl

Download URL quadrants-1.4.0b3-cp313-cp313-win_amd64.whl
Size 29.0 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
8ea607a59cf57f7a4fdead5a0d282c08d37c4d0adc66b040abd8de0bc28b00df
BLAKE2b-256 checksum
How to use checksums
65eb5098db761a2e3f05f4c89de9efb391ff1446d0dbd383fbda61016c9a4ef0
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.0b3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b3-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
79ecf41307f8dc66eb6a2e5dba8af996b5732f2753888f5a5ee7f80bd8d9bcc1
BLAKE2b-256 checksum
How to use checksums
482d8302aceb92224d8af8414765485d3dfe2bb19ee70c1b065000fdb3f8b81c
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.0b3-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b3-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
4a5ed228aadde3dd6a8bdb8aa6b62747f3ef88d04c562712c7c91e51477462e5
BLAKE2b-256 checksum
How to use checksums
e37cf6846c2fdab84bd10598b7a0741fd140daaa3931ba363c6829f5db4f7442
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.0b3-cp313-cp313-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b3-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
f80131f80f9481b6301b199d190f4a52594d75e60aec4f750ff0a574e8722920
BLAKE2b-256 checksum
How to use checksums
1dceb17a039615bc93461fad660a9a6462417d3a2386e7d4ea59bdef9da15cbb
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.0b3-cp312-cp312-win_amd64.whl

Download URL quadrants-1.4.0b3-cp312-cp312-win_amd64.whl
Size 29.0 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
3367ac5c55b3af651b44dd81ee1512f0e0b746e9dcb026c76bc4183cfabc7ad8
BLAKE2b-256 checksum
How to use checksums
a7b5a84f568cfc9d3d8bdffdce4b1ba354f39752ea37f2c575eb0168ea7a1eff
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.0b3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b3-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
f3275697822f0f15e44709ee5380568d782ea1ee50b960cb3d18de490180155f
BLAKE2b-256 checksum
How to use checksums
9e2f4cc35978d4e996f10754f927395f05e5ecf37482f081e72d37e8a8896d16
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.0b3-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b3-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
628de06200d9d68f4c5c8acfecfccb80e4ba46f410f19c2fc67be011666abe91
BLAKE2b-256 checksum
How to use checksums
f54c08c4383d1cad0744eb98294a0fb64a1ad7f716aa4140328087286829f063
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.0b3-cp312-cp312-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b3-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
1e2d22eb9c7c8deba5e4ce1181f6f7251f7c456220c27eda8ac69aad2873942c
BLAKE2b-256 checksum
How to use checksums
53d00adbf73c3339b30485b2f1ae24e48f5756f3509fba39cfe0381244a9f26c
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.0b3

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
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