Installing AdvanceSyn Toolkit

Welcome and thank you for choosing AdvanceSyn Toolkit. We hope that you will have a pleasant journey with us.

Before we start, you will need to install AdvanceSyn Toolkit. There are 2 methods for installing AdvanceSyn Toolkit:

• Installation by Forking - Preferred method as it is more thorough but it takes more steps.
• Installation by Cloning - Fewer steps but less thorough.

---

Installation by Forking

1. You will need to have a GitHub account, which can register for an account here. You can learn more about Git and Git processes here.
2. Once you log in, click on discover repository and search for "AdvanceSyn Toolkit" or you can go directly to my AdvanceSyn Toolkit repository and click on Fork at the top right hand corner. This will fork AdvanceSyn Toolkit from my repository to yours. This will recreate a linked replica of AdvanceSyn Toolkit from my repository (https://github.com/mauriceling/advancesyntoolkit) to yours (https://github.com/[your-GitHub-user-name]/advancesyntoolkit). This linking is important for updating purposes, and it is this linking that requires more steps.
3. You will need to download and install a Git client - there are many choices in this area. I recommend SmartGit as a graphical-based Git client.
4. Then you need to clone AdvanceSyn Toolkit from your GitHub repository on the cloud / internet (https://github.com/XXXXX/advancesyntoolkit where XXXXX is your GitHub user name) into your local machine (usually, your laptop). If you are done with this step, the AdvanceSyn Toolkit will be linked to the AdvanceSyn Toolkit in your GitHub repository; which, in turn, is linked to AdvanceSyn Toolkit in my repository (https://github.com/mauriceling/advancesyntoolkit) - This link is critical.
5. Next, you will need to install Python programming platform on your computer / laptop. You will need Python 3.7 (You may use Python 3.8 if you do not need to use Cameo), which can be downloaded here. If you are using Windows, please remember to set the path.

To test your installation:

1. Launch command line
2. Go to AdvanceSyn Toolkit folder within command line
3. Execute python astools.py systemdata. If you get an error suggesting that fire is not found, it is likely that you have 2 versions of Python in your computer (usually the case if you are using Mac OSX or other Linux-based systems); then, you will probably need to execute python3 astools.py systemdata instead.
4. Finally, install all the external tools and dependencies needed by AdvanceSyn Toolkit by executing python astools.py installdep or python3 astools.py systemdata, depending on the response of the last instruction.

If you don't see any errors, CONGRATULATIONS and lets have a drink.

---

Installation by Cloning

1. You can download AdvanceSyn Toolkit from here and unzip it. It will produce a folder called advancesyntoolkit-master, which you can rename into advancesyntoolkit if you like.
2. Next, you will need to install Python programming platform on your computer / laptop. You will need Python 3.7 (You may use Python 3.8 if you do not need to use Cameo), which can be downloaded here. If you are using Windows, please remember to set the path.

To test your installation:

1. Launch command line
2. Go to AdvanceSyn Toolkit folder within command line
3. Execute python astools.py systemdata. If you get an error suggesting that fire is not found, it is likely that you have 2 versions of Python in your computer (usually the case if you are using Mac OSX or other Linux-based systems); then, you will probably need to execute python3 astools.py systemdata instead.
4. Finally, install all the external tools and dependencies needed by AdvanceSyn Toolkit by executing python astools.py installdep or python3 astools.py systemdata, depending on the response of the last instruction.

If you don't see any errors, CONGRATULATIONS and lets have a drink.