SOFA policy is to support only the latest Windows version.

Installation with Pixi

You can download and build SOFA in only three steps without any environment installation.

Prerequisites

Installation steps

Clone SOFA : git clone https://github.com/sofa-framework/sofa :inbox_tray:
Trigger the build : run pixi run -e supported-plugins build in the sofa source folder :desktop_computer:
Launch SOFA : run pixi run -e supported-plugins runSofa :rocket:

Manual installation (for developpers)

This installation method is advised for developers. It is STRONGLY advised to read through this entire doc page before getting started.

## Build tools ## Build tools ### Compiler SOFA requires a [C++17 compatible compiler](https://en.cppreference.com/w/cpp/compiler_support#C.2B.2B17_features). On Windows, we officially support **Microsoft Visual Studio >= 2017** (version 15.7). If you want to use **Visual Studio IDE**, install the complete Visual Studio solution. If you want to use **another IDE** (like QtCreator), install the Build Tools only. | | **Visual Studio 2017** | **Visual Studio 2019** | **Visual Studio 2022** | |-----------------------|:------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------------------------:| | **Build Tools only** | [download](https://visualstudio.microsoft.com/fr/thank-you-downloading-visual-studio/?sku=BuildTools&rel=15) | [download](https://visualstudio.microsoft.com/fr/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16) | [download](https://visualstudio.microsoft.com/fr/thank-you-downloading-visual-studio/?sku=BuildTools&rel=17) | | **IDE + Build Tools** | [download](https://visualstudio.microsoft.com/fr/thank-you-downloading-visual-studio/?sku=Community&rel=15) | [download](https://visualstudio.microsoft.com/fr/thank-you-downloading-visual-studio/?sku=Community&rel=16) | [download](https://visualstudio.microsoft.com/fr/thank-you-downloading-visual-studio/?sku=Community&rel=17) | In the installer, you must enable: 1. In the main panel: the **C++ development toolkit**, called "C++ Build Tools" or "Desktop C++". 2. In the side panel: the **C++ ATL** and **C++ MFC** components. ![](https://www.sofa-framework.org/wp-content/uploads/2020/03/install_vs_ide.png) ### CMake: Makefile generator SOFA requires at least **CMake 3.22.1**. Install CMake with [the latest official installer](https://github.com/Kitware/CMake/releases/latest). **IMPORTANT**: check the option **"Add CMake to the system PATH for all users"** during the install process. ![](https://www.sofa-framework.org/wp-content/uploads/2019/03/install-cmake.png) ### [optional] Ninja: build system We strongly advise you to use Ninja if you chose to install the Build Tools only (no IDE). Ninja is an alternative to NMake. It has a better handling of incremental builds. You can download the latest release from [their GitHub repository](https://github.com/ninja-build/ninja/releases). **IMPORTANT**: do not forget to **add ninja to your system PATH**. ## Dependencies ### Core (required) SOFA requires some libraries: - **Boost** (>= 1.65.1) Download and install the latest version compatible with your Visual Studio from [https://sourceforge.net/projects/boost/files/boost-binaries/](https://sourceforge.net/projects/boost/files/boost-binaries/). - **For Visual Studio 2022**: choose boost_X_X_X-msvc-14.3-64.exe - **For Visual Studio 2019**: choose boost_X_X_X-msvc-14.2-64.exe - **For Visual Studio 2017**: choose boost_X_X_X-msvc-14.1-64.exe - **Python** (= 3.12.x) Download and install the latest [**Python 3.12 (amd64)**](https://www.python.org/ftp/python/3.12.10/python-3.12.10-amd64.exe). Python 3.12 now favor the use of venv. We highly recommend it too. To bootstrap it type `C:\path\to\python3.12 -m venv sofa-venv` in the folder you want to keep this venv. We recommend creating it either in your home directory, in the folder containing both your sources and the build directory. Once created, you can activate it by calling `C:\path\to\sofa-venv\bin\Scripts\activate.bat`. Now you can install all dependency through the following commands. Then, install the Python dependencies. Run the following commands in cmd by replacing `path\to\Python312\` by the path to you venv bin directory.

path\to\Python312\python.exe -m pip install --upgrade pip
path\to\Python312\python.exe -m pip install numpy scipy pybind11==2.12.0

Now, each time you want to build or use SOFA, you first need to call `C:\path\to\sofa-venv\bin\Scripts\activate.bat` to activate this virtual environment and get access to the dependencies. - **Additional libraries**: libPNG, libJPEG, libTIFF, Glew, Zlib, TinyXML2 It will be fetch automatically from https://github.com/sofa-framework/WinDepPack.git directly by SOFA CMake generation. For advanced dev, you can provide you own by modfying the CMake variables WINDEPPACK_GIT_REPOSITORY and WINDEPPACK_GIT_TAG. - **Eigen** (>= 3.2.10) Download and extract the [latest Eigen sources](https://gitlab.com/libeigen/eigen/-/releases). #### [optional] PATH modification You can add Boost to your PATH to ease their detection by CMake. **Boost**: add `your/Boost/path` and `your/Boost/path/libXX-msvc-XX` ## Build SOFA ### Setup your source and build directories To set up clean repositories, we recommend to arrange the SOFA directories as follows:

sofa/
├── build/
│   ├── master/
│   └── v25.12/
└── src/
    └── < SOFA sources here >

**First**, checkout the sources from Git repository: Get the current **stable** version on the v25.12 branch:

git clone -b v25.12 https://github.com/sofa-framework/sofa.git sofa/src

**OR** get the development **unstable** version on the master branch:

git clone -b master https://github.com/sofa-framework/sofa.git sofa/src

### Generate a VS project (.sln) or a Makefile with CMake 1. Create build directories respecting the arrangement above. 2. In Windows Start menu, search for `Native Tools Command Prompt` and run the one corresponding to your Windows architecture (x64 for 64-bit, x86 for 32-bit). ![](https://www.sofa-framework.org/wp-content/uploads/2020/04/SearchCommandPrompt2.png) 3. Call ``C:\path\to\sofa-venv\bin\Scripts\activate.bat`` to activate the virtual environment. 4. In the command prompt, type `cmake-gui` and press Enter. If you get the error `'cmake-gui' is not recognized as an internal or external command`, it means that your system PATH does not correctly include the path to cmake-gui. In this case, you need to provide the full path to your cmake-gui. 5. In CMake-GUI, set source folder and build folder. 6. Run **Configure**. 7. A pop-up will ask you to specify the generator for the project. - If you want use **Visual Studio IDE**, select "Visual Studio 15 2017 Win64" or "Visual Studio 16 2019 Win64" (or without the "Win64" if you are on Windows 32-bit). - If you want to use **another IDE like QtCreator**, select "CodeBlocks - Ninja" (recommended, needs [Ninja](#optional-ninja-build-system)) or "CodeBlocks - NMake". Keep "Use default native compilers" and press "Finish". 8. Fix eventual dependency errors by following CMake messages (see Troubleshoot section below). You may ignore warnings. - e.g. define the `Eigen3_DIR` with the path where you installed Eigen - Add the path to your venv site-packages to CMake by setting a path variable called `CMAKE_PREFIX_PATH=C:\path\to\sofa-venv\Lib\site-packages` 9. (optional) Customize SOFA via CMake variables - choose the build type by setting CMAKE_BUILD_TYPE to "Release" or "RelWithDebInfo" (recommended) or "Debug" - activate or deactivate plugins: see PLUGIN_XXX variables - activate or deactivate features: see SOFA_XXX variables Do not forget to **Configure** again to check if your changes are valid. **_NOTE_**: here is an [exhaustive list of plugins](../activate-plugins/) that can be activated for an in-tree compilation. 10. When you are ready, run **Generate**. In the build directory, this will create a Visual Studio project (.sln) or a Makefile depending on the generator you chose at step 4. ### Compile To build SOFA in Visual Studio, simply **open the generated Sofa.sln**. Finally, **build the solution** using the Visual Studio interface as shown in the image below: ![](https://www.sofa-framework.org/wp-content/uploads/2019/03/build-visual.png) If you chose another generator you will have to run the generator from the build directory. Example with Ninja: - In Windows Start menu, search for `Native Tools Command Prompt` and run the one corresponding to your Windows architecture (x64 for 64-bit, x86 for 32-bit). - Go to the build directory with `cd` - Run `ninja` Time for a coffee! ### Setup script To simplify the configuration of our continuous integration machines, we created a complete set of setup scripts. These scripts install a lot of software directly in `C:\` without any prealable check. It is meant to be used on a **fresh Windows**. We use it on disposable virtual machines only. Setup script: [I am aware of the disclaimer above](https://github.com/sofa-framework/ci/blob/master/setup/) **WARNING: USE AT YOUR OWN RISKS** The two scripts `setup-windows_1.bat` and `setup-windows_2.bat` install the minimum set of requirements. ### Compilation tutorial See our page presenting [video tutorial for compilation on Windows](../../video-tutorials/how-to-compile-sofa/#windows).

Run SOFA

with the SOFA GUI

To run SOFA, locate and execute the application called runSofa. For more detailed information on how to use the application, you can refer to the page dedicated to runsofa. This documentation will provide you with further guidance on using SOFA effectively.

within a Python environment

To use SOFA within a Python3 environment, the section "using Python3" details how to set up your environment on various operating systems.