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.0a28-9-gdc988bd” 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.0a28-9-gdc988bd” (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.