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

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

Total release size: 541.0 MB

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

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

Download URL quadrants-1.4.0b1-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
150e49cced51faf11a2f5959a23ecf5ba0d150a68cf38e110ab75a1f94723b20
BLAKE2b-256 checksum
How to use checksums
8e1214f3d329879742162b38bcbfea9246a687da2a9ffa43f734e9b08cb8173c
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.0b1-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b1-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
71730329174d26f1de9e1d09b42613d7b4e025500d0e7f069d675a0c7472effe
BLAKE2b-256 checksum
How to use checksums
4cad65a083b7d2cbfc5a5e221ee15aca6492c11fea6b50410aa01e4ab004a0d3
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.0b1-cp313-cp313-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b1-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
b28a72522f46fba4078b733e013beb47c3f181f7f5988f8fec30e25df19e74a0
BLAKE2b-256 checksum
How to use checksums
62a667bc02d02f704b53098e61ddc6a79740f5fe476c85de506ea4b4b97059b3
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.0b1-cp312-cp312-win_amd64.whl

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

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

Download URL quadrants-1.4.0b1-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
503658704b1b854fcaae70902ac8947bcaa3eb2bf2c7c4f6fb2924b1d841d7d6
BLAKE2b-256 checksum
How to use checksums
59062e4b99c68e40ccad4e38bb4c82d1b037b16c5c4d2f4eb6669667cd18434e
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.0b1-cp312-cp312-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b1-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
4ff89686c6624d7a20c576a2884407ce171ca44724e012a8b2b809c9087cfb81
BLAKE2b-256 checksum
How to use checksums
977ef66705b207e874de701d121e8581279314d8a1ccac7a8066662eb595e470
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.0b1-cp311-cp311-win_amd64.whl

Download URL quadrants-1.4.0b1-cp311-cp311-win_amd64.whl
Size 29.0 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
7f013c0159d2a992a3aad77c797ee969116831af0ef48f14acc51b7f58570f89
BLAKE2b-256 checksum
How to use checksums
85c2ad8d10c281de1fbc2ddce2ab3fa48a4a954e71fb8b5234b3868fc4d2cbfb
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.0b1-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b1-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
8c6b7ebc3c4e3206d0a94fc80210dec1530512eba26d078955016c301259171f
BLAKE2b-256 checksum
How to use checksums
16fb01aa888ff6a060d32d0b7873fd99f1328b83af1e80f1c9e26325136049fe
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.0b1-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b1-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
005cae6c8626a56105e08cb572a4c683ca2e173db9b81ea971091462af2f9f17
BLAKE2b-256 checksum
How to use checksums
a5530f5df52fd24bbeaf806a4e27115e0fb3701ea3ab9d42efa797c2d06f5793
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.0b1-cp311-cp311-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b1-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
65c5af88e64fcd5c79dc0793f29d227f5e31ab63dfedd5b5d7ae5d4f2838bb4c
BLAKE2b-256 checksum
How to use checksums
7b8e144f53e86db788cd5d01bf7e26ebc057d453c9cf0dd4d9f2f3ea21b92ed2
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.0b1-cp310-cp310-win_amd64.whl

Download URL quadrants-1.4.0b1-cp310-cp310-win_amd64.whl
Size 29.0 MB
Tags CPython 3.10 Windows x86-64
SHA-256 checksum
How to use checksums
ac93325ed80f5237a1e4cf04a54381ecdde9fe6027e0d2d856f4724f088684f4
BLAKE2b-256 checksum
How to use checksums
29f6348f39655413d469e8ad87a31565a01a1a0a7f480191aef64e2c499cb560
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.0b1-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl

Download URL quadrants-1.4.0b1-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
cec0ca859516ed7962d0e7db16c789069bc2f72369e993d22e79bd2ef11c8fc3
BLAKE2b-256 checksum
How to use checksums
5e4baa9c9c3d6529d875bc27f86f008f1a3eda53756d3613048615d4675ba115
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.0b1-cp310-cp310-manylinux_2_27_aarch64.manylinux_2_34_aarch64.whl

Download URL quadrants-1.4.0b1-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
5a50f048282871ffe355b431e623d2986f8477f53e79f2e0af2b24be0d074c17
BLAKE2b-256 checksum
How to use checksums
563615af859df738969e823ea125cad22dbfcc4ba541c05f90bdc37eb11baec9
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.0b1-cp310-cp310-macosx_13_0_arm64.whl

Download URL quadrants-1.4.0b1-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
bd092b5385f9943ffa92218a93e68187aa928d3890c3ec4c5887a84ba27d0745
BLAKE2b-256 checksum
How to use checksums
55523d7787f610f0255f8e325cd20d78ab8e463ccc8a9e4b92b4f0c5f646d136
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.0b1

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