<h1 align="center"><img src="docs/_static/pygfx.svg" height="80"><br>Pygfx</h1>
[
](https://github.com/pygfx/pygfx/actions/workflows/ci.yml)
[
](https://docs.pygfx.org)
[
](https://badge.fury.io/py/pygfx)
The purpose of Pygfx is to bring powerful and reliable visualization to the Python world. 🚀
Pygfx (py-graphics) is built on [wgpu](https://github.com/pygfx/wgpu-py/), enabling superior performance and reliability compared to OpenGL-based solutions. It is designed for simplicity and versatility: with its modular architecture, you can effortlessly assemble graphical scenes for diverse applications, from scientific visualization to video game rendering.
<p align="center">
<img src="./docs/_static/readme_sponza.png" alt="drawing" width="200"/>
<img src="./docs/_static/readme_pbr_example.webp" alt="drawing" width="200"/>
<img src="./docs/_static/readme_torus_knot_wire.png" alt="drawing" width="200"/>
</p>
<p align="center">
[<a href="https://docs.pygfx.org/stable/guide.html">User Guide</a>]
[<a href="https://docs.pygfx.org/stable/_gallery/index.html">Example Gallery</a>]
[<a href="https://docs.pygfx.org/stable/reference.html">API Reference</a>]
</p>
Need help? We offer [professional support](https://pygfx.org/sponsor.html).
## Installation
```bash
pip install -U pygfx glfw
```
To work correctly, Pygfx needs _some_ window to render to. Glfw is one
lightweight option, but there are others, too. If you use a different
wgpu-compatible window manager or only render offscreen you may choose to omit
glfw. Examples of alternatives include: `jupyter_rfb` (rendering in Jupyter),
`PyQt`, `PySide`, or `wx`.
In addition there are some platform
requirements, see the [wgpu docs](https://wgpu-py.readthedocs.io/en/stable/start.html). In
essence, you need modern (enough) graphics drivers, and `pip>=20.3`.
## Status
We're currently working towards version `1.0`, which means that the API
can change with each version. We expect to reach `1.0` near July 2026,
at which point we start caring about backwards compatibility.
This means that until then, you should probably pin the Pygfx version
that you're using, and check the [release notes](https://github.com/pygfx/pygfx/releases)
when you update.
## Usage Example
> **Note**
> The example below is designed against the `main` branch,
> and may not work on the latest release from pypi, while we're in beta.
> **Note**
> A walkthrough of this example can be found in [the
> guide](https://docs.pygfx.org/stable/guide.html#how-to-use-pygfx).
```python
import pygfx as gfx
import pylinalg as la
cube = gfx.Mesh(
gfx.box_geometry(200, 200, 200),
gfx.MeshPhongMaterial(color="#336699"),
)
rot = la.quat_from_euler((0, 0.01), order="XY")
def animate():
cube.local.rotation = la.quat_mul(rot, cube.local.rotation)
if __name__ == "__main__":
gfx.show(cube, before_render=animate)
```
<img src="./docs/_static/guide_rotating_cube.gif" alt="drawing" width="400"/>
## Feature Highlights
Some of Pygfx's key features are:
- SDF based text rendering ([example](
https://docs.pygfx.org/stable/_gallery/feature_demo/text_contrast.html))
- order-independent transparency (OIT) ([example](
https://docs.pygfx.org/stable/_gallery/feature_demo/transparency2.html))
- lights, shadows, and physically based rendering (PBR) ([example](
https://docs.pygfx.org/stable/_gallery/feature_demo/pbr.html))
- event system with built-in picking ([example](
https://docs.pygfx.org/stable/_gallery/feature_demo/picking_points.html))
- texture and color mapping supporting 1D, 2D and 3D data ([example](
https://docs.pygfx.org/stable/_gallery/feature_demo/colormap_channels.html))
And many more! Check out our [feature demos](
https://docs.pygfx.org/stable/_gallery/index.html) in the docs.
## License
Pygfx is licensed under the [BSD 2-Clause "Simplified" License](LICENSE). This means:
- :white_check_mark: It is free (and open source) forever. :cupid:
- :white_check_mark: You _can_ use it commercially.
- :white_check_mark: You _can_ distribute it and freely make changes.
- :x: You _can not_ hold us accountable for the results of using Pygfx.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).
### Development Install
To get a working dev install of Pygfx you can use the following steps:
```bash
# Click the Fork button on GitHub and navigate to your fork
git clone <address_of_your_fork>
cd pygfx
# if you use a venv, create and activate it
pip install -e ".[dev,docs,examples]"
pytest tests
```
### Testing
The test suite is divided into three parts; unit tests for the core, unit
tests for the examples, and screenshot tests for the validation examples.
* `pytest -v tests` runs the core unit tests.
* `pytest -v examples` tests the examples.
The screenshot tests are difficult to guarantee across all development
platforms and are best run on our CI where more predictable outcomes can be
achieved. They can run on a local linux machine by selecting the software
rendering adapter and the tests with the command
* `PYGFX_WGPU_ADAPTER_NAME=llvmpipe pytest examples -k test_examples_compare`
Note that our `pytest.ini` file contains the environment variable
`PYGFX_DISABLE_SYSTEM_FONTS=1` to help ensure consistency across system
installations.
### Code of Conduct
Our code of conduct can be found here: [Code of Conduct](./CODE_OF_CONDUCT.md)
## Spelling and pronunciation
Lowercase "pygfx" is used in code. You can refer to the project in written text using "Pygfx".
Pygfx is pronounced as *pie-graphics*.
Raw data
{
"_id": null,
"home_page": null,
"name": "pygfx",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "render-engine, graphics, 3d, science, visualization, webgpu, wgpu",
"author": "Almar Klein, Korijn van Golen",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/9f/5d/b15602a352c2fd224f8c19dbab1ca2fa2645e4032c034a9327600f42def0/pygfx-0.13.0.tar.gz",
"platform": null,
"description": "<h1 align=\"center\"><img src=\"docs/_static/pygfx.svg\" height=\"80\"><br>Pygfx</h1>\n\n[\n](https://github.com/pygfx/pygfx/actions/workflows/ci.yml)\n[\n](https://docs.pygfx.org)\n[\n](https://badge.fury.io/py/pygfx)\n\nThe purpose of Pygfx is to bring powerful and reliable visualization to the Python world. \ud83d\ude80\n\nPygfx (py-graphics) is built on [wgpu](https://github.com/pygfx/wgpu-py/), enabling superior performance and reliability compared to OpenGL-based solutions. It is designed for simplicity and versatility: with its modular architecture, you can effortlessly assemble graphical scenes for diverse applications, from scientific visualization to video game rendering.\n\n<p align=\"center\">\n<img src=\"./docs/_static/readme_sponza.png\" alt=\"drawing\" width=\"200\"/>\n<img src=\"./docs/_static/readme_pbr_example.webp\" alt=\"drawing\" width=\"200\"/>\n<img src=\"./docs/_static/readme_torus_knot_wire.png\" alt=\"drawing\" width=\"200\"/>\n</p>\n<p align=\"center\">\n[<a href=\"https://docs.pygfx.org/stable/guide.html\">User Guide</a>]\n[<a href=\"https://docs.pygfx.org/stable/_gallery/index.html\">Example Gallery</a>]\n[<a href=\"https://docs.pygfx.org/stable/reference.html\">API Reference</a>]\n</p>\n\nNeed help? We offer [professional support](https://pygfx.org/sponsor.html).\n\n## Installation\n\n```bash\npip install -U pygfx glfw\n```\n\nTo work correctly, Pygfx needs _some_ window to render to. Glfw is one\nlightweight option, but there are others, too. If you use a different\nwgpu-compatible window manager or only render offscreen you may choose to omit\nglfw. Examples of alternatives include: `jupyter_rfb` (rendering in Jupyter),\n`PyQt`, `PySide`, or `wx`.\n\nIn addition there are some platform\nrequirements, see the [wgpu docs](https://wgpu-py.readthedocs.io/en/stable/start.html). In\nessence, you need modern (enough) graphics drivers, and `pip>=20.3`.\n\n## Status\n\nWe're currently working towards version `1.0`, which means that the API\ncan change with each version. We expect to reach `1.0` near July 2026, \nat which point we start caring about backwards compatibility.\n\nThis means that until then, you should probably pin the Pygfx version\nthat you're using, and check the [release notes](https://github.com/pygfx/pygfx/releases)\nwhen you update.\n\n## Usage Example\n\n> **Note**\n> The example below is designed against the `main` branch,\n> and may not work on the latest release from pypi, while we're in beta.\n\n> **Note**\n> A walkthrough of this example can be found in [the\n> guide](https://docs.pygfx.org/stable/guide.html#how-to-use-pygfx).\n\n```python\nimport pygfx as gfx\nimport pylinalg as la\n\ncube = gfx.Mesh(\n gfx.box_geometry(200, 200, 200),\n gfx.MeshPhongMaterial(color=\"#336699\"),\n)\n\nrot = la.quat_from_euler((0, 0.01), order=\"XY\")\n\ndef animate():\n cube.local.rotation = la.quat_mul(rot, cube.local.rotation)\n\nif __name__ == \"__main__\":\n gfx.show(cube, before_render=animate)\n\n```\n<img src=\"./docs/_static/guide_rotating_cube.gif\" alt=\"drawing\" width=\"400\"/>\n\n\n## Feature Highlights\nSome of Pygfx's key features are:\n\n- SDF based text rendering ([example](\n https://docs.pygfx.org/stable/_gallery/feature_demo/text_contrast.html))\n- order-independent transparency (OIT) ([example](\n https://docs.pygfx.org/stable/_gallery/feature_demo/transparency2.html))\n- lights, shadows, and physically based rendering (PBR) ([example](\n https://docs.pygfx.org/stable/_gallery/feature_demo/pbr.html))\n- event system with built-in picking ([example](\n https://docs.pygfx.org/stable/_gallery/feature_demo/picking_points.html))\n- texture and color mapping supporting 1D, 2D and 3D data ([example](\n https://docs.pygfx.org/stable/_gallery/feature_demo/colormap_channels.html))\n\n\nAnd many more! Check out our [feature demos](\nhttps://docs.pygfx.org/stable/_gallery/index.html) in the docs.\n\n## License\n\nPygfx is licensed under the [BSD 2-Clause \"Simplified\" License](LICENSE). This means:\n\n- :white_check_mark: It is free (and open source) forever. :cupid:\n- :white_check_mark: You _can_ use it commercially.\n- :white_check_mark: You _can_ distribute it and freely make changes.\n- :x: You _can not_ hold us accountable for the results of using Pygfx.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n### Development Install\nTo get a working dev install of Pygfx you can use the following steps:\n\n```bash\n# Click the Fork button on GitHub and navigate to your fork\ngit clone <address_of_your_fork>\ncd pygfx\n# if you use a venv, create and activate it\npip install -e \".[dev,docs,examples]\"\npytest tests\n```\n\n### Testing\n\nThe test suite is divided into three parts; unit tests for the core, unit\ntests for the examples, and screenshot tests for the validation examples.\n\n* `pytest -v tests` runs the core unit tests.\n* `pytest -v examples` tests the examples.\n\nThe screenshot tests are difficult to guarantee across all development\nplatforms and are best run on our CI where more predictable outcomes can be\nachieved. They can run on a local linux machine by selecting the software\nrendering adapter and the tests with the command\n\n* `PYGFX_WGPU_ADAPTER_NAME=llvmpipe pytest examples -k test_examples_compare`\n\nNote that our `pytest.ini` file contains the environment variable\n`PYGFX_DISABLE_SYSTEM_FONTS=1` to help ensure consistency across system\ninstallations.\n\n\n### Code of Conduct\n\nOur code of conduct can be found here: [Code of Conduct](./CODE_OF_CONDUCT.md)\n\n\n## Spelling and pronunciation\n\nLowercase \"pygfx\" is used in code. You can refer to the project in written text using \"Pygfx\".\nPygfx is pronounced as *pie-graphics*.\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Powerful and versatile visualization for Python",
"version": "0.13.0",
"project_urls": {
"Documentation": "https://docs.pygfx.org",
"Homepage": "https://pygfx.org",
"Repository": "https://github.com/pygfx/pygfx"
},
"split_keywords": [
"render-engine",
" graphics",
" 3d",
" science",
" visualization",
" webgpu",
" wgpu"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e4b709878a7fa0cd5b208b4e8de148fad3052b9420dae2f774f350b2fdc8cb17",
"md5": "ea3f85f3690e60f6f9fbacff782bf6a9",
"sha256": "d74cd1ed7db5880d5eff99493cc01f3a8ac9713163abb9cc6eec4a7a633646c2"
},
"downloads": -1,
"filename": "pygfx-0.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ea3f85f3690e60f6f9fbacff782bf6a9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 1213733,
"upload_time": "2025-09-05T10:43:32",
"upload_time_iso_8601": "2025-09-05T10:43:32.248556Z",
"url": "https://files.pythonhosted.org/packages/e4/b7/09878a7fa0cd5b208b4e8de148fad3052b9420dae2f774f350b2fdc8cb17/pygfx-0.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9f5db15602a352c2fd224f8c19dbab1ca2fa2645e4032c034a9327600f42def0",
"md5": "e33fbb1a27fd85e5330ab8f095158e35",
"sha256": "4a4ea67f410d5f365f267cbe10ada81b84ca9c4103f302c8b3b4aac129fe7447"
},
"downloads": -1,
"filename": "pygfx-0.13.0.tar.gz",
"has_sig": false,
"md5_digest": "e33fbb1a27fd85e5330ab8f095158e35",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 1131814,
"upload_time": "2025-09-05T10:43:33",
"upload_time_iso_8601": "2025-09-05T10:43:33.863770Z",
"url": "https://files.pythonhosted.org/packages/9f/5d/b15602a352c2fd224f8c19dbab1ca2fa2645e4032c034a9327600f42def0/pygfx-0.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-05 10:43:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pygfx",
"github_project": "pygfx",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pygfx"
}
JSON
