gstaichi


Namegstaichi JSON
Version 2.6.0 PyPI version JSON
download
home_pageNone
SummaryThe GsTaichi Programming Language
upload_time2025-10-07 16:30:49
maintainerGsTaichi developers
docs_urlNone
authorNone
requires_python<3.14,>=3.10
licenseNone
keywords graphics simulation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # GsTaichi

[GsTaichi](https://github.com/Genesis-Embodied-AI/gstaichi) was forked in June 2025. This repository (or gstaichi) is now a fully independent project with no intention of maintaining backward compatibility with the original taichi. Whilst the repo largely resembles upstream for now, we have made the following changes:
- revamped continuous integration, to run using recent python versions (up to 3.13), recent mac os x versions (up to 15), and to run reliably (at least 95% of runs with correct code succeed)
- added dataclasses.dataclass structs:
    - work with both ndarrays and fields (cf ti.struct (field only), ti.dataclass (field only), ti.data_oriented (field only), argpack (ndarray only))
    - can be passed into child `ti.func`tions (cf argpack)
    - does not affect kernel runtime speed (kernels see only the underlying arrays, no indirection is added within the kernel layer)
- removed GUI/GGUI, C-API, AOT, DX11, DX12, IOS, Android, OpenGL, GLES

Planned features:
- reduce warm cache launch latency
- (maybe) add launch args caching, to reduce launch latency
- make dataclasses.dataclass nestable

Planned pruning:
- remove argpack
- remove ti CLI
- remove support for NVidia GPUs earlier than sm_60/Pascal

# What is gstaichi?

GsTaichi is a high performance multi-platform compiler, targeted at physics simulations. It compiles Python code into parallelizable kernels that can run on:
- NVidia GPUs, using CUDA
- Vulkan-compatible GPUs, using SPIR-V
- Mac Metal GPUs
- x86 and arm64 CPUs

GsTaichi supports automatic differentiation. GsTaichi lets you build fully fused GPU kernels, using Python.

[Genesis simulator](https://genesis-world.readthedocs.io/en/latest/)'s best-in-class performance can be largely attributed to Taichi, its underlying GPU acceleration framework for Python. Given how critical is this component, we decided to fork Taichi and build our own very framework from there, so that from now on, we are free to drive its development in the direction that best supports the continuous improvement of Genesis simulator.

# Installation
## Prerequisites
- Python 3.10-3.13
- Mac OS 14, 15, Windows, or Ubuntu 22.04-24.04 or compatible

## Procedure
```
pip install gstaichi
```

(For how to build from source, see our CI build scripts, e.g. [linux build scripts](.github/workflows/scripts_new/linux_x86/) )

# Documentation

- [docs](https://genesis-embodied-ai.github.io/gstaichi/user_guide/index.html)
- [API reference](https://genesis-embodied-ai.github.io/gstaichi/autoapi/index.html)

# Something is broken!

- [Create an issue](https://github.com/Genesis-Embodied-AI/gstaichi/issues/new/choose)

# Acknowledgements

- The original [Taichi](https://github.com/taichi-dev/taichi) was developed with love by many contributors over many years. For the full list of contributors and credits, see [Original taichi contributors](https://github.com/taichi-dev/taichi?tab=readme-ov-file#contributing)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "gstaichi",
    "maintainer": "GsTaichi developers",
    "docs_url": null,
    "requires_python": "<3.14,>=3.10",
    "maintainer_email": null,
    "keywords": "graphics, simulation",
    "author": null,
    "author_email": null,
    "download_url": null,
    "platform": null,
    "description": "# GsTaichi\n\n[GsTaichi](https://github.com/Genesis-Embodied-AI/gstaichi) was forked in June 2025. This repository (or gstaichi) is now a fully independent project with no intention of maintaining backward compatibility with the original taichi. Whilst the repo largely resembles upstream for now, we have made the following changes:\n- revamped continuous integration, to run using recent python versions (up to 3.13), recent mac os x versions (up to 15), and to run reliably (at least 95% of runs with correct code succeed)\n- added dataclasses.dataclass structs:\n    - work with both ndarrays and fields (cf ti.struct (field only), ti.dataclass (field only), ti.data_oriented (field only), argpack (ndarray only))\n    - can be passed into child `ti.func`tions (cf argpack)\n    - does not affect kernel runtime speed (kernels see only the underlying arrays, no indirection is added within the kernel layer)\n- removed GUI/GGUI, C-API, AOT, DX11, DX12, IOS, Android, OpenGL, GLES\n\nPlanned features:\n- reduce warm cache launch latency\n- (maybe) add launch args caching, to reduce launch latency\n- make dataclasses.dataclass nestable\n\nPlanned pruning:\n- remove argpack\n- remove ti CLI\n- remove support for NVidia GPUs earlier than sm_60/Pascal\n\n# What is gstaichi?\n\nGsTaichi is a high performance multi-platform compiler, targeted at physics simulations. It compiles Python code into parallelizable kernels that can run on:\n- NVidia GPUs, using CUDA\n- Vulkan-compatible GPUs, using SPIR-V\n- Mac Metal GPUs\n- x86 and arm64 CPUs\n\nGsTaichi supports automatic differentiation. GsTaichi lets you build fully fused GPU kernels, using Python.\n\n[Genesis simulator](https://genesis-world.readthedocs.io/en/latest/)'s best-in-class performance can be largely attributed to Taichi, its underlying GPU acceleration framework for Python. Given how critical is this component, we decided to fork Taichi and build our own very framework from there, so that from now on, we are free to drive its development in the direction that best supports the continuous improvement of Genesis simulator.\n\n# Installation\n## Prerequisites\n- Python 3.10-3.13\n- Mac OS 14, 15, Windows, or Ubuntu 22.04-24.04 or compatible\n\n## Procedure\n```\npip install gstaichi\n```\n\n(For how to build from source, see our CI build scripts, e.g. [linux build scripts](.github/workflows/scripts_new/linux_x86/) )\n\n# Documentation\n\n- [docs](https://genesis-embodied-ai.github.io/gstaichi/user_guide/index.html)\n- [API reference](https://genesis-embodied-ai.github.io/gstaichi/autoapi/index.html)\n\n# Something is broken!\n\n- [Create an issue](https://github.com/Genesis-Embodied-AI/gstaichi/issues/new/choose)\n\n# Acknowledgements\n\n- The original [Taichi](https://github.com/taichi-dev/taichi) was developed with love by many contributors over many years. For the full list of contributors and credits, see [Original taichi contributors](https://github.com/taichi-dev/taichi?tab=readme-ov-file#contributing)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "The GsTaichi Programming Language",
    "version": "2.6.0",
    "project_urls": {
        "Homepage": "https://github.com/Genesis-Embedded-AI/gstaichi"
    },
    "split_keywords": [
        "graphics",
        " simulation"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0df318ef9b42c9a6975d9e1973ec2c8ffdca31e15eb10b8f57c4a26a9e8ca5fd",
                "md5": "6eec1827f70c7a740ff8c25cd3ebf6d9",
                "sha256": "1c331af0e237b4bf25917fc35a7fc3ad0396e5f0aea5201365d90471229d444d"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp310-cp310-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "6eec1827f70c7a740ff8c25cd3ebf6d9",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": "<3.14,>=3.10",
            "size": 26884501,
            "upload_time": "2025-10-07T16:30:49",
            "upload_time_iso_8601": "2025-10-07T16:30:49.923851Z",
            "url": "https://files.pythonhosted.org/packages/0d/f3/18ef9b42c9a6975d9e1973ec2c8ffdca31e15eb10b8f57c4a26a9e8ca5fd/gstaichi-2.6.0-cp310-cp310-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "f8b07a7d85f2119613f6be54b3cba33d8a467819a0c381bc6cee2d223fd5d642",
                "md5": "2c5e5ce1bbf0838f3cc64705371b5813",
                "sha256": "dad60b4b703d6eaaf9538351c5c9a2e4007f9fea27672fa2cbf5ce07023821f7"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "has_sig": false,
            "md5_digest": "2c5e5ce1bbf0838f3cc64705371b5813",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": "<3.14,>=3.10",
            "size": 32678620,
            "upload_time": "2025-10-07T16:28:35",
            "upload_time_iso_8601": "2025-10-07T16:28:35.702593Z",
            "url": "https://files.pythonhosted.org/packages/f8/b0/7a7d85f2119613f6be54b3cba33d8a467819a0c381bc6cee2d223fd5d642/gstaichi-2.6.0-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0b6cc18a0a9e5d00c82f5bfceb7c0e22683cb78fae8fba12de351c1cc2fe158c",
                "md5": "bf0468d4f7c987da13141c2936186cd0",
                "sha256": "0284eac26d6cce4f1e03a97d57891df1c0ded36b9257fbb0eafbf35a4b48e8ec"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp310-cp310-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "bf0468d4f7c987da13141c2936186cd0",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": "<3.14,>=3.10",
            "size": 52299398,
            "upload_time": "2025-10-07T16:37:13",
            "upload_time_iso_8601": "2025-10-07T16:37:13.669652Z",
            "url": "https://files.pythonhosted.org/packages/0b/6c/c18a0a9e5d00c82f5bfceb7c0e22683cb78fae8fba12de351c1cc2fe158c/gstaichi-2.6.0-cp310-cp310-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "3e5373fd0bfeeb6f75a47f0e1c70095395276f54b94104b8282047e860b241fa",
                "md5": "57b3426353e1ca128717c8e84e53de48",
                "sha256": "3fbf91d86695a3d4eee089fe66ae81fae01364c98be26b5169268009f771092c"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp311-cp311-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "57b3426353e1ca128717c8e84e53de48",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": "<3.14,>=3.10",
            "size": 26888586,
            "upload_time": "2025-10-07T16:30:54",
            "upload_time_iso_8601": "2025-10-07T16:30:54.597504Z",
            "url": "https://files.pythonhosted.org/packages/3e/53/73fd0bfeeb6f75a47f0e1c70095395276f54b94104b8282047e860b241fa/gstaichi-2.6.0-cp311-cp311-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0001c0a03a41538d831f7b37213ae4323521a74d7ea6b78e9173548eb80ec8e5",
                "md5": "cd59d47324866fa0d4cd90765fc992ed",
                "sha256": "b8405353f5eb4847169096a5d22e94a9491281a38e53d3fd661b48993078fb81"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "has_sig": false,
            "md5_digest": "cd59d47324866fa0d4cd90765fc992ed",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": "<3.14,>=3.10",
            "size": 32680155,
            "upload_time": "2025-10-07T16:28:38",
            "upload_time_iso_8601": "2025-10-07T16:28:38.003429Z",
            "url": "https://files.pythonhosted.org/packages/00/01/c0a03a41538d831f7b37213ae4323521a74d7ea6b78e9173548eb80ec8e5/gstaichi-2.6.0-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "337d16f35a744f69a181e38c3aad2f4d1a5477630e43bccd5ac70d9a107bc86c",
                "md5": "8739b702705c8bad00fe17d455e7dd12",
                "sha256": "14fac2cf9c598a1f2e157fb451007b5a5d6087d0df4ef064e72260cbf0eebd8e"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp311-cp311-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "8739b702705c8bad00fe17d455e7dd12",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": "<3.14,>=3.10",
            "size": 52303887,
            "upload_time": "2025-10-07T16:37:07",
            "upload_time_iso_8601": "2025-10-07T16:37:07.056316Z",
            "url": "https://files.pythonhosted.org/packages/33/7d/16f35a744f69a181e38c3aad2f4d1a5477630e43bccd5ac70d9a107bc86c/gstaichi-2.6.0-cp311-cp311-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cdded57e8c6e62f3c4cb1d497ae9bdea4fa9925342b4add053465b877f07743f",
                "md5": "0d463c41d01a239e27d331a044934f9e",
                "sha256": "8a7aa2e18302521e314018b879025da4078e37294bd8751c55db5d8e56cdb5ab"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp312-cp312-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "0d463c41d01a239e27d331a044934f9e",
            "packagetype": "bdist_wheel",
            "python_version": "cp312",
            "requires_python": "<3.14,>=3.10",
            "size": 26885653,
            "upload_time": "2025-10-07T16:30:53",
            "upload_time_iso_8601": "2025-10-07T16:30:53.435696Z",
            "url": "https://files.pythonhosted.org/packages/cd/de/d57e8c6e62f3c4cb1d497ae9bdea4fa9925342b4add053465b877f07743f/gstaichi-2.6.0-cp312-cp312-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "50b4886b00ddc35f7a90200b6bfd34bc21215dbc4a9bd3e8ce7f08c1f5ff904a",
                "md5": "db202a918f03927a72c3af2cfcaf3dc3",
                "sha256": "9313d6ff993f054ad4e6df3df31d16a07f7c8b2c94f0debf521d1ffedef926a1"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "has_sig": false,
            "md5_digest": "db202a918f03927a72c3af2cfcaf3dc3",
            "packagetype": "bdist_wheel",
            "python_version": "cp312",
            "requires_python": "<3.14,>=3.10",
            "size": 32678503,
            "upload_time": "2025-10-07T16:28:39",
            "upload_time_iso_8601": "2025-10-07T16:28:39.240034Z",
            "url": "https://files.pythonhosted.org/packages/50/b4/886b00ddc35f7a90200b6bfd34bc21215dbc4a9bd3e8ce7f08c1f5ff904a/gstaichi-2.6.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2f6aec96f88260069e7ac8cc5474ca6a7993bc03bd3c35edff823793c60193d4",
                "md5": "ef75c6af5b4233f58e9f6ac5dcb0d36f",
                "sha256": "a6a451320630e976cbd1532044fa3c49a2df6f38326b0663557468ab25dd104d"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp312-cp312-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "ef75c6af5b4233f58e9f6ac5dcb0d36f",
            "packagetype": "bdist_wheel",
            "python_version": "cp312",
            "requires_python": "<3.14,>=3.10",
            "size": 52303622,
            "upload_time": "2025-10-07T16:37:07",
            "upload_time_iso_8601": "2025-10-07T16:37:07.991128Z",
            "url": "https://files.pythonhosted.org/packages/2f/6a/ec96f88260069e7ac8cc5474ca6a7993bc03bd3c35edff823793c60193d4/gstaichi-2.6.0-cp312-cp312-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2c9a06745edb4f6d3277289cede613db7ce3ca28ca2f4f454b88f27e458de2bd",
                "md5": "83e2369e931d01acaadf934f61694540",
                "sha256": "e58cfaad1054656c4c95a4e058940cb3cedf471f77e12e021b6a7e0e0c109ae0"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp313-cp313-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "83e2369e931d01acaadf934f61694540",
            "packagetype": "bdist_wheel",
            "python_version": "cp313",
            "requires_python": "<3.14,>=3.10",
            "size": 26889915,
            "upload_time": "2025-10-07T16:30:50",
            "upload_time_iso_8601": "2025-10-07T16:30:50.148331Z",
            "url": "https://files.pythonhosted.org/packages/2c/9a/06745edb4f6d3277289cede613db7ce3ca28ca2f4f454b88f27e458de2bd/gstaichi-2.6.0-cp313-cp313-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "975cd49a2c8bc452f8a3806bd208f19345313cc85ff50400527bb036ee06a205",
                "md5": "c1bec831b53db6b19546e25f5df77669",
                "sha256": "4ea18ebb122993da12e97becf88aa4b7903ebf41a147dbb90111c06f22cddd30"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "has_sig": false,
            "md5_digest": "c1bec831b53db6b19546e25f5df77669",
            "packagetype": "bdist_wheel",
            "python_version": "cp313",
            "requires_python": "<3.14,>=3.10",
            "size": 32680595,
            "upload_time": "2025-10-07T16:28:39",
            "upload_time_iso_8601": "2025-10-07T16:28:39.301303Z",
            "url": "https://files.pythonhosted.org/packages/97/5c/d49a2c8bc452f8a3806bd208f19345313cc85ff50400527bb036ee06a205/gstaichi-2.6.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1595c48a57cf768bc60cf877288172614e8d3c3790934d62337331c20017b271",
                "md5": "983cb0105982841fde57dbc6ecf7f34a",
                "sha256": "3ea11c84f384e037fa86e4d03603e6dd746d0be55073eb64295d38eeedac8823"
            },
            "downloads": -1,
            "filename": "gstaichi-2.6.0-cp313-cp313-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "983cb0105982841fde57dbc6ecf7f34a",
            "packagetype": "bdist_wheel",
            "python_version": "cp313",
            "requires_python": "<3.14,>=3.10",
            "size": 52304942,
            "upload_time": "2025-10-07T16:37:14",
            "upload_time_iso_8601": "2025-10-07T16:37:14.923236Z",
            "url": "https://files.pythonhosted.org/packages/15/95/c48a57cf768bc60cf877288172614e8d3c3790934d62337331c20017b271/gstaichi-2.6.0-cp313-cp313-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-07 16:30:49",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Genesis-Embedded-AI",
    "github_project": "gstaichi",
    "github_not_found": true,
    "lcname": "gstaichi"
}
        
Elapsed time: 1.33648s