Install Oasys in Windows 10‐11 - oasys-kit/oasys-installation-scripts GitHub Wiki

1) Download the installation scripts

You can obtain the installation scripts by going to the code page of this repository and downloading the content as a zip file:

We suggest to decompress the file in the Desktop, to have easy access of it.

2) Launch the installation script:

By using File Explorer, go to the folder Desktop\oasys-installation-scripts\Windows, and double-click the executable install_oasys1.3.bat.

Alternatively, you can open a command prompt and type:

cd Desktop\oasys-installation-scripts\Windows

install_oasys1.3

If the procedure is correctly executed, Oasys should appear. Click the button "Add-Ons" in the initial form and install the required Add-ons.

3) Start Oasys:

Double-click the link to the application that has been created on your desktop.

Alternatively, you can open a Miniconda prompt:

and type the command:

python -m oasys.canvas

4) In case of failure of the script

Some users encounter problems while the script is installing PyQt, that runs into an error and fails. Other users, instead, could not automatically download the Miniconda installer encountering permission errors, possibly due to their firewall configuration. Said that, the only solution we found so far is to do a manual, step-by-step installation, following the instructions here.

Known Issues

High DPI displays may cause some problem to run Oasys. The solution is to override high DPI scaling behavior for the python executable of your Miniconda installation:

  1. Right-click C:\Users\<user name>\Miniconda3\python.exe and select "Properties"
  2. In the Compatibility tab, Click "Change high DPI settings"
  3. Check "Override high DPI scaling behavior" and select "System (Enhanced)"
  4. Click Ok and then Ok or Apply.


Recently, for not yet determined causes, some internal libraries (i.e. oasys-srpy are not found and after the installation and OASYS won't start or some Add-ons are empty. The installation of OASYS takes care of it, but, in case you still have the problem, you can run a dedicated script:

By using File Explorer, go to the folder Desktop\oasys-installation-scripts\Windows, and double-click the executable fix_libraries1.3.bat.

Alternatively, you can open a command prompt and type:

cd Desktop\oasys-installation-scripts\Windows

fix_libraries1.3

Recently, the Add-on ShadowOui-Advanced-Tools does not install correctly, since the package retrieved by pip is corrupted.

By using File Explorer, go to the folder Desktop\oasys-installation-scripts\Windows, and double-click the executable fix_addons1.3.bat.

Alternatively, you can open a command prompt and type:

cd Desktop\oasys-installation-scripts\Windows

fix_addons1.3
⚠️ **GitHub.com Fallback** ⚠️