.. only:: comment

    © Crown-owned copyright 2023, Defence Science and Technology Laboratory UK

.. _getting-started:

Getting Started
===============

**Getting Started with PrimAITE**

Pre-Requisites

In order to get **PrimAITE** installed, you will need to have a python version between 3.8 and 3.11 installed. If you don't already have it, this is how to install it:


.. code-block:: bash
    :caption: Unix

    sudo add-apt-repository ppa:deadsnakes/ppa
    sudo apt install python3.10
    sudo apt-get install python3-pip
    sudo apt-get install python3-venv


.. code-block:: text
    :caption: Windows (Powershell)

    - Manual install from: https://www.python.org/downloads/release/python-31011/

**PrimAITE** is designed to be OS-agnostic, and thus should work on most variations/distros of Linux, Windows, and MacOS.

Install PrimAITE
****************

1. Create a directory for your PrimAITE project:

.. code-block:: bash
    :caption: Unix

    mkdir ~/primaite/3.0.0

.. code-block:: powershell
    :caption: Windows (Powershell)

    mkdir ~\primaite\3.0.0


2. Navigate to the primaite directory and create a new python virtual environment (venv)

.. code-block:: bash
    :caption: Unix

    cd ~/primaite/3.0.0
    python3 -m venv .venv

.. code-block:: powershell
    :caption: Windows (Powershell)

        cd ~\primaite\3.0.0
        python3 -m venv .venv
        attrib +h .venv /s /d # Hides the .venv directory


3. Activate the venv

.. code-block:: bash
    :caption: Unix

    source .venv/bin/activate

.. code-block:: powershell
    :caption: Windows (Powershell)

    .\.venv\Scripts\activate


4. Install PrimAITE from your saved wheel file

.. code-block:: bash
    :caption: Unix

    pip install path/to/your/primaite.whl

.. code-block:: powershell
    :caption: Windows (Powershell)

    pip install path\to\your\primaite.whl


5. Install ARCD GATE from wheel file


.. code-block:: bash
    :caption: Unix

    pip install path/to/your/arcd_gate-0.1.0-py3-none-any.whl

.. code-block:: powershell
    :caption: Windows (Powershell)

    pip install path\to\your\arcd_gate-0.1.0-py3-none-any.whl


6. Perform the PrimAITE setup

.. code-block:: bash
    :caption: Unix

    primaite setup

.. code-block:: powershell
    :caption: Windows (Powershell)

        primaite setup

Clone & Install PrimAITE for Development
****************************************

To be able to extend PrimAITE further, or to build wheels manually before install, clone the repository to a location
of your choice:

1. Clone the repository

.. code-block:: bash

    git clone https://github.com/Autonomous-Resilient-Cyber-Defence/PrimAITE
    cd primaite

2. Create and activate your Python virtual environment (venv)

.. code-block:: bash
    :caption: Unix

    python3 -m venv venv
    source venv/bin/activate

.. code-block:: powershell
    :caption: Windows (Powershell)

    python3 -m venv venv
    .\venv\Scripts\activate

3. Install PrimAITE with the dev extra

.. code-block:: bash
    :caption: Unix

    pip install -e .[dev]

.. code-block:: powershell
    :caption: Windows (Powershell)

    pip install -e .[dev]


4. Install ARCD GATE from wheel file

.. code-block:: bash
    :caption: Unix

    pip install GATE/arcd_gate-0.1.0-py3-none-any.whl

.. code-block:: powershell
    :caption: Windows (Powershell)

    pip install GATE\arcd_gate-0.1.0-py3-none-any.whl

To view the complete list of packages installed during PrimAITE installation, go to the dependencies page (:ref:`Dependencies`).