documentation/installation.md

+**Please read the whole section before starting the install procedure.**
+
+[[_TOC_]]
+
+The recommended installation procedure relies on creating a virtual environment to handle PASE dependencies.
+
+The repository provides environment files for setting up a conda virtual environment with all necessary dependencies. There are two separate files:
+
+- One for Windows users: `environment_windows.yml`
+- One for Unix-based systems (macOS and GNU/Linux, such as Ubuntu, Debian, etc.): `environment_unix.yml`
+
+# Conda Installation
+
+If you haven’t installed Conda, we recommend following the [Conda installation guide](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html). Here are some options to consider:
+
+- **Good option:** Install **Anaconda** for a comprehensive installation.
+- **Better option:** Install **Miniconda** for a lighter, customizable setup.
+- **Best option:** Install **Miniforge** (optimized for Conda-forge) and consider using [Mamba](https://mamba.readthedocs.io/en/latest/installation/mamba-installation.html), which is faster and more efficient than Conda.
+
+# Windows Installation
+
+1. Create the `pase` virtual environment:
+   
+   ```bash
+   conda env create -f environment_windows.yml
+   ```
+
+2. Activate the environment:
+   
+   ```bash
+   conda activate pase
+   ```
+
+3. Install Embree-related dependencies with pip (while this is not standard practice in Conda, it should work without issues):
+   
+   ```bash
+   pip install pyembree embreex
+   ```
+
+4. The framework is now ready for use (for advanced crop modeling, see section [Installing JavaStics](#installing-javastics)).
+
+# Unix-based Installation
+
+1. Create the `pase` virtual environment:
+   
+   ```bash
+   conda env create -f environment_unix.yml
+   ```
+
+2. Activate the environment:
+   
+   ```bash
+   conda activate pase
+   ```
+
+3. The framework is now ready for use (for advanced crop modeling, see section [Installing JavaStics](#installing-javastics)).
+
+# Installing JavaStics
+
+Due to license incompatibilities, the JavaStics 1.5.1 executable is not included in the PASE repository.
+
+If you want to use the crop model STICS, download JavaStics 1.5.1 : https://stics.inrae.fr/telechargement and place the executable "JavaSticsCmd.exe" under INPUTS/CROPS/STICS.
\ No newline at end of file