First of all you need to install a recent version of Python 3. Please visit the python website download and install Python 3. Python should be added to the PATH environment variable.

A great Python IDE is PyCharm. PyCharm offers a community version which can be used for free for non-commercial purposes. Please visit the PyCharm download page, download and install PyCharm.

Alternatively you can install the Jetbrains Toolbox which lets you easily install and update PyCharm and other tools. To get the Toolbox please visit the Jetbrains Toolbox download page.

From commandline install virtualenv and the virtualenv-wrapper.

On Windows, run

pip install virtualenv virtualenvwrapper-win

and on Linux, run

pip install virtualenv virtualenvwrapper

To create an virtual python environment for the demo, run

mkvirtualenv htf-demo

To install and update the htf-demo packet, run

pip install -i -U htf-demo

htf-demo uses the community license by default to easily get you started.

In case you want to create a new directory for the demo files, run the following

mkdir htf-demo
cd htf-demo

To setup the demo files, run

demo init .
add2virtualenv .

This will copy all needed python scripts into your project directory. Simply open the folder in PyCharm to start.

The htf demo is now ready to use and you can proceed to the next section.

If you prefer visual assistance, you can take a look at the video below. (The first step, installing virtualenv and virtualenv-wrapper, is not shown in the video)

Proxy Server

If you are behind a proxy server, you need to set the “https_proxy” environment variable.

On Windows, run

set https_proxy=https://username:password@proxyserver:port

and on Linux, run

export https_proxy=https://username:password@proxyserver:port

before running pip. Please replace username, password, proxy server and port with appropriate values meeting your networking environment.

SSL Verification

In some circumstances it might be necessary to disable SSL verification. To do this simply add the option --insecure to hlm activate or hlm renew or set the environment variable HLM_INSECURE to any value.

Demo-license Activation

If you’d like to checkout features not included in the community-edition like Signed-reports, HART and Modbus you have to contact us to let us create a demo-license for you.

To activate the demo-license run

hlm purge
hlm activate <your-demo-license-key>


If you have any questions please contact us via e-mail to

We hope that you will like HILSTER Testing Framework and the demo we provided to you.

We highly appreciate your feedback and we will contact you in about two weeks to talk about HILSTER Testing Framework and your experiences.