Updating Finesse

Since Finesse is still in alpha stage, we recommended staying up to date with the latest release, since we are continuously improving the software and fixing bugs. See the Changelog for the latest changes and subscribe to the matrix channel to get notified of new releases

Conda

Make sure you have your Finesse environment actiavted:

$ conda activate finesse

Update the Finesse package from conda-forge:

(finesse) $ conda update -c conda-forge finesse

Sometimes conda refuses to update to the latest version, because of version incompatibilities. The latest version of Finesse is “3.0a29” and you can request it:

(finesse) $ conda update -c conda-forge finesse==<latest_version>

Conda environment can be broken for various reasons, and refuse to install the latest version of Finesse. When that happens, it is recommended to create a fresh environment to install the latest version, following the instructions here. To delete an existing conda environment:

(finesse) $ conda activate base
(base) $ conda env remove -n finesse

Warning

Deleting your finesse environment will also delete any extra dependencies that you may have installed over time. You can run conda env export -f old_environment.yml to create a backup environment file to revert to with conda env create -f old_environment.yml

From PyPI (with e.g. pip)

Simply run:

pip install -U finesse

in your virtual finesse environment. See installation from PyPI for more details on setting up a virtual environment.

Source install

Check out the latest version tag “3.0a29” (or possibly a branch or a special commit) that you want to update to with git:

git checkout <finesse_version>

Then choose the appropriate make target for your setup:

# For a python virtual environment setup
make develop-pep517
# For a conda setup
make develop-conda

See Rebuilding extensions for more details.