Prerequisites

For this course you will need to have the following dependencies installed on your computer:

Java

If you are following this course on a Linux or macOS computer, you will need Java version 11 or higher.


                java -version
            

To check the Java version available on your computer, do the following:


            java version "17.0.2" 2022-01-18 LTS
            Java(TM) SE Runtime Environment (build 17.0.2+8-LTS-86)
            Java HotSpot(TM) 64-Bit Server VM (build 17.0.2+8-LTS-86, mixed mode, sharing)
        

If you don't have Java installed, you can install it by following the instructions available at Java Downloads.

Python

To confirm the Python version available on your system, do the following:


            python --version
        

The output of the command should be something like:


            Python 3.10.2
        

In case Python is not available on your system, follow the instructions available in the guide Installing Python.

On some systems Python version 3 may be accessible as python3 or py. For these cases, test the version with:


                    python3 --version
                    # or
                    py --version
        

Python packages

We will also need some Python packages that will be used throughout the process.

Even if you have these packages installed, ideally they are up-to-date.

pip install --upgrade pip setuptools virtualenv cookiecutter


Note: It may be that on your system pip is identified as pip3. Adjust the above command as needed.

Other dependencies (Linux)

If you are following this course with a Linux operating system, you will also need to have some system libraries installed.


                apt install python3-tk    # Adjust according to your Python version
                apt install scrot
                apt install xclip
            

Checking the environment

To ensure everything is okay to proceed, try following the steps below.

Creating a virtual environment with virtualenv

Let's test the virtualenv installation by creating a temporary virtual environment:

python -m venv temp

Activate the virtual environment

Let's activate the virtual environment to make sure everything is correct:

Windows

            
                temp/Scripts/activate
            
        

Linux/MacOS

            
                source temp/bin/activate
            
        

Installing a package

Let's check permissions and system operation by installing a package:

pip install botcity-framework-core

Deactivating the virtual environment

If we got this far, your environment is correctly configured! 🏆

Deactivate the virtual environment with the command below and remove the folder 'temp'.

deactivate