This release is a pre-release and may not be stable for production use.
PyFluent
Overview
PyFluent provides Pythonic access to Ansys Fluent. Its features enable the seamless use of Fluent within the Python ecosystem and broad access to native Fluent features, including the ability to:
Launch Fluent using a local Ansys installation
Use Fluent’s TUI (text user interface) commands for both meshing and solver features
Use Fluent’s built-in postprocessing capabilities
Documentation and issues
Documentation for the latest stable release of PyFluent is hosted at PyFluent documentation.
In the upper right corner of the documentation’s title bar, there is an option for switching from viewing the documentation for the latest stable release to viewing the documentation for the development version or previously released versions.
You can also view or download the PyFluent cheat sheet. This one-page reference provides syntax rules and commands for using PyFluent.
On the PyFluent Issues page, you can create issues to report bugs and request new features. On the PyFluent Discussions page or the Discussions page on the Ansys Developer portal, you can post questions, share ideas, and get community feedback.
To reach the project support team, email pyansys.core@ansys.com.
Installation
The ansys-fluent-core package supports Python 3.10 through Python 3.14 on Windows and Linux.
Install the latest release from PyPI with:
pip install ansys-fluent-coreUsing a virtual environment
It is recommended to use a virtual environment when installing PyFluent to avoid conflicts with other Python packages. A virtual environment can be created and activated with the following commands:
python -m venv .venvOn Windows:
.venv\Scripts\activateOn Linux and Mac OS:
source .venv/bin/activateThen, install PyFluent in the virtual environment with:
python -m pip install ansys-fluent-coreDependencies
You must have a licensed copy of Ansys Fluent installed locally. PyFluent supports Fluent versions 2024 R2 SP05, 2025 R1 SP04, 2025 R2 SP03, 2026 R1, and later versions. The Windows installation of Ansys Fluent automatically sets the required environment variables so that PyFluent can find the Ansys Fluent installation. Using Fluent 2025 R2 (or 25.2) installed in the default directory as an example, the installer automatically sets the AWP_ROOT252 environment variable to point to C:\Program Files\ANSYS Inc\v252. On Linux, the required environment variable is not set automatically, and can be set for the current user in the current shell session, using Fluent 2025 R2 in the default installation directory as an example, before running PyFluent, with:
export AWP_ROOT252=/usr/ansys_inc/v252For this setting to persist between different shell sessions for the current user, the same export command can instead be added to the user’s ~/.profile file.
For developers
If you plan on doing local development of PyFluent with Git, install the latest release with:
git clone https://github.com/ansys/pyfluent.git
cd pyfluentCreate and activate a virtual environment:
python -m venv .venvOn Windows:
.venv\Scripts\activateOn Linux and Mac OS:
source .venv/bin/activateThen, install PyFluent in the virtual environment in editable mode with:
pip install pip -U
pip install -e .To generate API files, run one of the following commands:
python codegen/allapigen.pypython codegen/allapigen.py -vThe -v option displays the paths of the generated API files.
Getting started
Launching Fluent
To launch Fluent from Python, use the launch_fluent function:
import ansys.fluent.core as pyfluent
solver_session = pyfluent.launch_fluent()
solver_session.is_server_healthy()Basic usage
The solver_session interface provides a convenient way to launch and interact with Fluent.
import ansys.fluent.core as pyfluent
solver_session = pyfluent.launch_fluent()For more information on using the solver_session interface, see the PyFluent documentation.
For postprocessing and visualization, you can also install:
PyFluent Visualization, which enables analysis and plotting through the pyvista and matplotlib packages.
License and acknowledgments
PyFluent is licensed under the MIT license.
PyFluent makes no commercial claim over Ansys whatsoever. This library extends the functionality of Ansys Fluent by adding a Python interface to Fluent without changing the core behavior or license of the original software. The use of the interactive Fluent control of PyFluent requires a legally licensed local copy of Fluent.
For more information on Fluent, see the Ansys Fluent page on the Ansys website.
1 maintainer
Metadata
1 maintainer
Release files for ansys-fluent-core 0.44.dev0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ansys_fluent_core-0.44.dev0.tar.gz | 6.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ansys_fluent_core-0.44.dev0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.4 MB
Release files / ansys_fluent_core-0.44.dev0.tar.gz
| Download URL | ansys_fluent_core-0.44.dev0.tar.gz |
|---|---|
| Size | 6.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ba394f7253e3f10326b0bc0eda917c33f43abb8b02c31b5c6562cfbea9eca29
|
|
BLAKE2b-256 checksum How to use checksums |
1f3d039dee5fd0d885213bd3458ccaa8f96a37dd094cce9ce725423d70d42104
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / ansys_fluent_core-0.44.dev0-py3-none-any.whl
| Download URL | ansys_fluent_core-0.44.dev0-py3-none-any.whl |
|---|---|
| Size | 6.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d777928e2b7b222422d0d9b995f36386d470152cc371536e9cca3fae1a51d8b3
|
|
BLAKE2b-256 checksum How to use checksums |
6c5d6d94ed4867fc3446d80326df7d1958ed73a8f85495878a2a282ad955131d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency log
