From 472e85cffb17762342ce49d4f6608adabc2831a2 Mon Sep 17 00:00:00 2001 From: Chris McCarthy Date: Wed, 26 Jul 2023 21:49:36 +0100 Subject: [PATCH] Added additional install instructions to the README.md --- README.md | 76 ++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 61 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index d078829e..53d58509 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,72 @@ # PrimAITE +PrimAITE (Primary-level AI Training Environment) is a simulation environment for training AI under the ARCD programme. + ## Getting Started with PrimAITE - -### Pre-Requisites - -In order to get **PrimAITE** installed, you will need to have the following installed: - -- `python3.8+` -- `python3-pip` -- `virtualenv` - +### 💫 Install & Run **PrimAITE** is designed to be OS-agnostic, and thus should work on most variations/distros of Linux, Windows, and MacOS. +Currently, the PRimAITE wheel can only be installed from GitHub. This may change in the future with release to PyPi. -### Installation from source (Developer Install) -#### 1. Create a new python virtual environment (venv) +#### Windows (PowerShell) + +**Prerequisites:** +* Manual install of Python >= 3.8 < 3.11 + +**Install:** + +``` powershell +mkdir ~\primaite +cd ~\primaite +python3 -m venv .venv +attrib +h .venv /s /d # Hides the .venv directory +.\.venv\Scripts\activate +pip install https://github.com/Autonomous-Resilient-Cyber-Defence/PrimAITE/releases/download/v2.0.0/primaite-2.0.0-py3-none-any.whl +primaite setup +``` + +#### Unix + +**Prerequisites:** +* Manual install of Python >= 3.8 < 3.11 + +``` bash +sudo add-apt-repository ppa:deadsnakes/ppa +sudo apt install python3.10 +sudo apt-get install python3-pip +sudo apt-get install python3-venv +``` +**Install:** + +``` bash +mkdir ~/primaite +cd ~/primaite +python3 -m venv .venv +source .venv/bin/activate +pip install https://github.com/Autonomous-Resilient-Cyber-Defence/PrimAITE/releases/download/v2.0.0/primaite-2.0.0-py3-none-any.whl +primaite setup +``` + + +### Developer Install from Source +To make your own changes to PrimAITE, perform the install from source (developer install) + +#### 1. Clone the PrimAITE repository +``` unix +git clone git@github.com:Autonomous-Resilient-Cyber-Defence/PrimAITE.git +``` + +#### 2. CD into the repo directory +``` unix +cd PrimAITE +``` +#### 3. Create a new python virtual environment (venv) ```unix python3 -m venv venv ``` -#### 2. Activate the venv +#### 4. Activate the venv ##### Unix ```bash @@ -32,19 +78,19 @@ source venv/bin/activate .\venv\Scripts\activate ``` -#### 3. Install `primaite` with the dev extra into the venv along with all of it's dependencies +#### 5. Install `primaite` with the dev extra into the venv along with all of it's dependencies ```bash python3 -m pip install -e .[dev] ``` -#### 4. Perform the PrimAITE setup: +#### 6. Perform the PrimAITE setup: ```bash primaite setup ``` -## Building documentation +## 📚 Building documentation The PrimAITE documentation can be built with the following commands: ##### Unix