.. _source:

Development installation on Linux or macOS
===========================================

To contribute to the NNPDF code,
you will need to install a development version of the code.

Code development is carried out using Github, see :ref:`gitsection`.

While we recommend that you install ``nnpdf`` in the most comfortable way for your workflow,
installing some of the dependencies such as LHAPDF might be challenging.
Below we describe how to prepare a development environment using conda.

1. Setup a conda environment with a recent python version supported by NNPDF (for 4.0.10, this corresponds to ``python>=3.9.2,<3.13``).

.. code::

   conda create -n nnpdf_dev lhapdf pandoc python==3.12 -c conda-forge


2. Clone the repository

.. code::

    git clone https://github.com/NNPDF/nnpdf.git
    cd nnpdf


3. Install NNPDF packages and its dependencies (make sure the conda environment
   is activated)

.. code::

  conda activate nnpdf_dev
  python -m pip install -e .

.. note::

  Following the installation steps above will set up a development
  environment that makes it possible to run and work on the nnpdf code. One
  may wish to install additional, optional, dependencies. Depending on the
  specific needs for an environment this can be dependencies that enable the
  running of the CI test, building the documentations, or performing a QED fit.

    .. code::

      python -m pip install -e .[tests,docs,qed]