V5:Installing ChipWhisperer/Installing ChipWhisperer from Releases

Once you have a working Python installation, you're ready to install and run ChipWhisperer.

First, download a ChipWhisperer release. You can get these from the Releases page. Generally, the latest release is a good choice, but you might need an older version for various reasons. You want the source code in .zip or .tar.gz format - not a VBox image.

Next, uncompress your downloaded source code somewhere. Generally, 'somewhere' will become your ChipWhisperer working directory. For example, on Windows, you might want to use C:\chipwhisperer\.

Once you've got the file, install the python dependencies and run the Python install procedure (setup.py). Use the develop command to indicate that the files will probably be changing frequently. to do this, open a terminal and run the following, adjusting paths as needed:

cd chipwhisperer/software
pip install -r requirements.txt
python setup.py develop 

NB: This assumes the python command links to Python-3.x, and not Python-2.7. You may need to specify python3 and pip3 as the command instead of python and pip to force this.

To test, run python and try importing the chipwhisperer module:

python
>>> import chipwhisperer as cw

If you want to run the tutorial notebooks, run

jupyter notebook

. A new window should be opened in your browser.