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.

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

  • Python backend — qd.init(qd.python) interprets kernels as plain Python so they can be stepped through in a standard Python debugger

Installation

Prerequisites

  • Python 3.10-3.13
  • 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.0b2

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

Total release size: 541.0 MB

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

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

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

Download URL quadrants-1.4.0b2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.1 MB
Tags CPython 3.13 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
8238f676e7c07ec44b7435d598d94bb18e402d8f6101f1f95936eb281a40364e
BLAKE2b-256 checksum
How to use checksums
84d9594554c3699db4cac83bdb983cf6fb4ee94bccf78b24ec6e94cf5c4e72b9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

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

Download URL quadrants-1.4.0b2-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
Size 38.4 MB
Tags CPython 3.13 Linux glibc 2.27+ ARM64 Linux glibc 2.34+ ARM64
SHA-256 checksum
How to use checksums
f160198ef2dff906305d8c5bc49ff36b3cfc7b53abfc650500f07c9d5524ad08
BLAKE2b-256 checksum
How to use checksums
9e19fa3c8e763313851309524cd5480c055cbd968bd6db86eba1b53042739cd8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

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

Download URL quadrants-1.4.0b2-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
1f25cd76f98f89e9214d78304038b665d447c3e597b8124275fb1b634ced9b7b
BLAKE2b-256 checksum
How to use checksums
3358c27c2df5a6abc3ada7def4169179562e471afd0164218a94b038ff3d1ffd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

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

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

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

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

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

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

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

Download URL quadrants-1.4.0b2-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
6fc7ee73460d1b647633585b7067ebd6fd36676f165ca10dd9bdb409b92df22e
BLAKE2b-256 checksum
How to use checksums
83fa466c1d59c513539d7874f6582d32f6c581c39400bf8baf240335faf911f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp311-cp311-win_amd64.whl

Download URL quadrants-1.4.0b2-cp311-cp311-win_amd64.whl
Size 29.0 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
3c3390efa33584c960db7af6d3b93e2f0c81060e73b28d4c84d70a5e0821e67c
BLAKE2b-256 checksum
How to use checksums
7ed333f167544b84dc11e43253840f47d6cb352054517b045ae5e90ec699f3ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.1 MB
Tags CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
1844743ab1b0a83852315dff6552c68382d5ec8d8b81690ebf7f0654401d1c7c
BLAKE2b-256 checksum
How to use checksums
24583951ff27e8be722e11f451764b7831ec9849acc23e8939835ac97c8e7cdd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b2-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
Size 38.4 MB
Tags CPython 3.11 Linux glibc 2.27+ ARM64 Linux glibc 2.34+ ARM64
SHA-256 checksum
How to use checksums
7883065368d5581915678830ce2c8708b49f423aff72d57d58bdd1929f371317
BLAKE2b-256 checksum
How to use checksums
adcf970e0cce9eddebb6e11c309a4f9b9850f736bb45cfaf7e51a2762a2b19f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp311-cp311-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b2-cp311-cp311-macosx_13_0_arm64.whl
Size 26.8 MB
Tags CPython 3.11 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
6992965f1eab383e89644bd1e049e6643f04fbc5f7f64d51065dc779df7bcf87
BLAKE2b-256 checksum
How to use checksums
6c264c47256cb182f3b9ce5633c16933b2ea057296fabd843633b870eb2128df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp310-cp310-win_amd64.whl

Download URL quadrants-1.4.0b2-cp310-cp310-win_amd64.whl
Size 29.0 MB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
f7c1250c079396c3481c0c403b23a740c374723b573c4230d618b578a6969474
BLAKE2b-256 checksum
How to use checksums
1eb604fa147893d9225e5d8ec5365f2dbebe48c2e637ffe16dfdc4eb5ce01e42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Size 41.1 MB
Tags CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
a3e721a2e54ac11255c4cc92dfff0b13592d473621b8a896b2b5bba825ad2ae9
BLAKE2b-256 checksum
How to use checksums
84d3703d59c72b7a3fd839b40307d0e5221694d58061f154510afd82f72b5692
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b2-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl
Size 38.4 MB
Tags CPython 3.10 Linux glibc 2.27+ ARM64 Linux glibc 2.34+ ARM64
SHA-256 checksum
How to use checksums
f991e6a73bedd2f312b83755f4b1e4ec06afe7d6edd990ec012de029ef246e19
BLAKE2b-256 checksum
How to use checksums
bda0622754f179b68959436db86834cbbb4075e8d66530dac155a0dc5e52c533
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Release files / quadrants-1.4.0b2-cp310-cp310-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b2-cp310-cp310-macosx_13_0_arm64.whl
Size 26.8 MB
Tags CPython 3.10 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
6b5e9816407c1299d2b16082c8817ec95cb809f3272fb4a6ed3645fef32393eb
BLAKE2b-256 checksum
How to use checksums
9d4cc7e59d728bd23d0cbf37100cce32401594bf819004e059601b5fbcff9599
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.10.22

Security for quadrants 1.4.0b2

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