Skip to content

docs: Add virtual environment steps in installation guides [skip tests]#5178

Open
mkundu1 wants to merge 5 commits into
mainfrom
doc/venv
Open

docs: Add virtual environment steps in installation guides [skip tests]#5178
mkundu1 wants to merge 5 commits into
mainfrom
doc/venv

Conversation

@mkundu1

@mkundu1 mkundu1 commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Context

Usage of virtual environment was not mentioned in PyFluent docs (as the project was inherited from ansys-templates which also doesn't mention it). If virtual environment is not used, users can overwrite bundled PyFluent within an unified installation when they use Python from the unified installation.

Change Summary

Steps how to setup and use virtual environment while installing PyFluent in both default and developer mode have been mentioned in README and the installation guide. There was an FAQ entry for virtual environment-based setup which has been removed as the information is redundant.

Rationale

Using virtual environment while installing a Python package is a standard procedure and mentioning the same in PyFluent docs will guide users to follow best practices.

Impact

Installation guide will be improved.

@github-actions github-actions Bot added the documentation Documentation related (improving, adding, etc) label Jun 8, 2026
@codacy-production

codacy-production Bot commented Jun 8, 2026

Copy link
Copy Markdown

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@mkundu1 mkundu1 requested review from hpohekar, mayankansys, prmukherj and seanpearsonuk and removed request for mayankansys June 8, 2026 13:16
@mkundu1 mkundu1 marked this pull request as ready for review June 8, 2026 13:17
Using a virtual environment
~~~~~~~~~~~~~~~~~~~~~~~~~~~

It is recommended to use a virtual environment when installing PyFluent to avoid conflicts with other Python packages.

@seanpearsonuk seanpearsonuk Jun 9, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't we provide a more comprehensive rationale for using a virtual environment?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@seanpearsonuk Using a virtual environment is a standard practice for Python development and anything more we say here will become duplicate of official Python documentation. Should we just provide a link to the Python tutorial (https://docs.python.org/3/tutorial/venv.html) here?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation related (improving, adding, etc)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Mention virtual environment usage in PyFluent installation steps is docs

4 participants