From b86e20b1ef0315d9b75de5b32bc7417dbc8b4210 Mon Sep 17 00:00:00 2001 From: Rufino Cabrera Date: Fri, 24 Oct 2025 09:55:03 +0000 Subject: [PATCH 1/4] Add installation guides in Markdown format for CAI Pro v0.5 and v0.6 --- docs/Installation_Guide_for_CAI_Pro_v0.5.md | 129 +++++++++++++++++++ docs/Installation_Guide_for_CAI_Pro_v0.6.md | 131 ++++++++++++++++++++ 2 files changed, 260 insertions(+) create mode 100644 docs/Installation_Guide_for_CAI_Pro_v0.5.md create mode 100644 docs/Installation_Guide_for_CAI_Pro_v0.6.md diff --git a/docs/Installation_Guide_for_CAI_Pro_v0.5.md b/docs/Installation_Guide_for_CAI_Pro_v0.5.md new file mode 100644 index 00000000..74db2d14 --- /dev/null +++ b/docs/Installation_Guide_for_CAI_Pro_v0.5.md @@ -0,0 +1,129 @@ +# Installation Guide for CAI Pro v0.5 + +## Welcome to CAI Pro! + +If your subscription is active, you have received a confirmation email. Then, get and save your API-Key and please follow these instructions to install CAI Pro on your system. + +### Important + +- Your API Key is personal and non-transferable. +- It will be permanently linked to the first system where it is used. + +## System Requirements + +- OS: Ubuntu 24.04 (x86_64, 64-bit) +- Language: English +- Python: 3.8+ (installed automatically) +- Memory: Minimum 4 GB RAM + +## Installation Steps + +- Download the installer file we provided in the Confirmation to your CAI-Pro subscription: `cai-pro_Linux.deb` +- Open a terminal in your Downloads directory. +- Run the following commands: + - `sudo apt update` + - `sudo apt install ./cai-pro_Linux.deb` +- During installation, follow the instructions and you will be asked to provide your API Key: `sk--xxxxxxxxxxxxxxxx` +- Once completed, CAI will start automatically. + +## Accessing CAI + +- Desktop Icon → double-click on "CAI (by Alias Robotics)" +- Application Menu → search for "CAI" +- Command Line → run: `cai` + +## Support + +If you encounter any issues, contact us at: contact@aliasrobotics.com + +Although we do not provide official support for other operating systems, we offer the recommended installation steps below. + +## Installation Steps for Other OS + +### OS X + +```bash +brew update && \ +brew install git python@3.12 + +# Create virtual environment +python3.12 -m venv cai_env + +# Install the package from the local directory +source cai_env/bin/activate && pip install cai-framework + +# Generate a .env file and set up with defaults +echo -e 'OPENAI_API_KEY="sk-1234"\nANTHROPIC_API_KEY=""\nOLLAMA=""\nPROMPT_TOOLKIT_NO_CPR=1\nCAI_STREAM=false' > .env + +# Launch CAI +cai # first launch it can take up to 30 seconds +``` + +### Windows WSL + +Go to the Microsoft page: https://learn.microsoft.com/en-us/windows/wsl/install + +Here you will find all the instructions to install WSL. From Powershell write: `wsl --install` + +```bash +sudo apt-get update && \ +sudo apt-get install -y git python3-pip python3-venv + +# Create the virtual environment +python3 -m venv cai_env + +# Install the package from the local directory +source cai_env/bin/activate && pip install cai-framework + +# Generate a .env file and set up with defaults +echo -e 'OPENAI_API_KEY="sk-1234"\nANTHROPIC_API_KEY=""\nOLLAMA=""\nPROMPT_TOOLKIT_NO_CPR=1\nCAI_STREAM=false' > .env + +# Launch CAI +cai # first launch it can take up to 30 seconds +``` + +### Android + +We recommend having at least 8 GB of RAM: + +1. First of all, install userland: https://play.google.com/store/apps/details?id=tech.ula&hl=es +2. Install Kali minimal in basic options (for free). [Or any other kali option if preferred] +3. Update apt keys like in this example: https://superuser.com/questions/1644520/apt-get-update-issue-in-kali, inside UserLand's Kali terminal execute: + +```bash +# Get new apt keys +wget http://http.kali.org/kali/pool/main/k/kali-archive-keyring/kali-archive-keyring_2024.1_all.deb + +# Install new apt keys +sudo dpkg -i kali-archive-keyring_2024.1_all.deb && rm kali-archive-keyring_2024.1_all.deb + +# Update APT repository +sudo apt-get update + +# CAI requires python 3.12, lets install it (CAI for kali in Android) +sudo apt-get update && sudo apt-get install -y git python3-pip build-essential zlib1g-dev \ +libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev \ +wget libbz2-dev pkg-config + +wget https://www.python.org/ftp/python/3.12.4/Python-3.12.4.tar.xz +tar xf Python-3.12.4.tar.xz +cd Python-3.12.4 +./configure --enable-optimizations +sudo make altinstall # This command takes long to execute + +# Clone CAI's source code +git clone https://github.com/aliasrobotics/cai && cd cai + +# Create virtual environment +python3.12 -m venv cai_env + +# Install the package from the local directory +source cai_env/bin/activate && pip3 install -e . + +# Generate a .env file and set up +cp .env.example .env # edit here your keys/models + +# Launch CAI +cai +``` + diff --git a/docs/Installation_Guide_for_CAI_Pro_v0.6.md b/docs/Installation_Guide_for_CAI_Pro_v0.6.md new file mode 100644 index 00000000..da42a469 --- /dev/null +++ b/docs/Installation_Guide_for_CAI_Pro_v0.6.md @@ -0,0 +1,131 @@ +# Installation Guide for CAI Pro v0.6 + +## Welcome to CAI Pro! + +If your subscription is active, you have received a confirmation email. Then, get and save your API-Key and please follow these instructions to install CAI Pro on your system. + +### Important + +- Your API Key is personal and non-transferable. +- It will be permanently linked to the first system where it is used. + +## System Requirements + +- OS: Ubuntu 24.04 (x86_64, 64-bit) +- Language: English +- Python: 3.8+ (installed automatically) +- Memory: Minimum 4 GB RAM + +## Installation Steps + +- Create a folder in your preferred directory. +- Open a terminal in that directory. +- Create a virtual environment, activate it, and install CAI Pro with the following commands: + - `sudo apt update` + - `python3.12 -m venv cai_env` + - `source cai_env/bin/activate` + - `pip install --index-url https://packages.aliasrobotics.com:664// cai-framework` +- Important note: + - The last command requires customization. Replace `` with the API Key provided in the confirmation email for your subscription, for example: `sk--xxxxxxxxxxxxxxxx` +- Once the installation is complete, run: + - `cai –tui` + +## Accessing CAI + +- Command Line → run: `cai –tui` + +## Support + +If you encounter any issues, contact us at: contact@aliasrobotics.com + +Although we do not provide official support for other operating systems, we offer the recommended installation steps below. + +## Installation Steps for Other OS + +### OS X + +```bash +brew update && \ +brew install git python@3.12 + +# Create virtual environment +python3.12 -m venv cai_env + +# Install the package from the local directory +source cai_env/bin/activate && pip install cai-framework + +# Generate a .env file and set up with defaults +echo -e 'OPENAI_API_KEY="sk-1234"\nANTHROPIC_API_KEY=""\nOLLAMA=""\nPROMPT_TOOLKIT_NO_CPR=1\nCAI_STREAM=false' > .env + +# Launch CAI +cai # first launch it can take up to 30 seconds +``` + +### Windows WSL + +Go to the Microsoft page: https://learn.microsoft.com/en-us/windows/wsl/install + +Here you will find all the instructions to install WSL. From Powershell write: `wsl --install` + +```bash +sudo apt-get update && \ +sudo apt-get install -y git python3-pip python3-venv + +# Create the virtual environment +python3 -m venv cai_env + +# Install the package from the local directory +source cai_env/bin/activate && pip install cai-framework + +# Generate a .env file and set up with defaults +echo -e 'OPENAI_API_KEY="sk-1234"\nANTHROPIC_API_KEY=""\nOLLAMA=""\nPROMPT_TOOLKIT_NO_CPR=1\nCAI_STREAM=false' > .env + +# Launch CAI +cai # first launch it can take up to 30 seconds +``` + +### Android + +We recommend having at least 8 GB of RAM: + +1. First of all, install userland: https://play.google.com/store/apps/details?id=tech.ula&hl=es +2. Install Kali minimal in basic options (for free). [Or any other kali option if preferred] +3. Update apt keys like in this example: https://superuser.com/questions/1644520/apt-get-update-issue-in-kali, inside UserLand's Kali terminal execute: + +```bash +# Get new apt keys +wget http://http.kali.org/kali/pool/main/k/kali-archive-keyring/kali-archive-keyring_2024.1_all.deb + +# Install new apt keys +sudo dpkg -i kali-archive-keyring_2024.1_all.deb && rm kali-archive-keyring_2024.1_all.deb + +# Update APT repository +sudo apt-get update + +# CAI requires python 3.12, lets install it (CAI for kali in Android) +sudo apt-get update && sudo apt-get install -y git python3-pip build-essential zlib1g-dev \ +libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libsqlite3-dev \ +wget libbz2-dev pkg-config + +wget https://www.python.org/ftp/python/3.12.4/Python-3.12.4.tar.xz +tar xf Python-3.12.4.tar.xz +cd Python-3.12.4 +./configure --enable-optimizations +sudo make altinstall # This command takes long to execute + +# Clone CAI's source code +git clone https://github.com/aliasrobotics/cai && cd cai + +# Create virtual environment +python3.12 -m venv cai_env + +# Install the package from the local directory +source cai_env/bin/activate && pip3 install -e . + +# Generate a .env file and set up +cp .env.example .env # edit here your keys/models + +# Launch CAI +cai +``` + From 2d10bb45ac42f1e9e1c8b352d64db48c7298b99f Mon Sep 17 00:00:00 2001 From: Rufino Cabrera Date: Mon, 27 Oct 2025 14:55:51 +0100 Subject: [PATCH 2/4] Add references to CAI Pro installation guides in README Install section --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index f1330e77..f8f0c0b0 100644 --- a/README.md +++ b/README.md @@ -330,6 +330,13 @@ Cybersecurity AI is a critical field, yet many groups are misguidedly pursuing i ## :nut_and_bolt: Install +> [!NOTE] +> **CAI Professional Edition Users**: If you have an active CAI Pro subscription, we provide dedicated installation guides for versions 0.5 and 0.6. Official support is available for Ubuntu 24.04 (x86_64). Installation instructions for other operating systems are provided as-is without official support: +> - [CAI Pro v0.6 Installation Guide](docs/Installation_Guide_for_CAI_Pro_v0.6.md) +> - [CAI Pro v0.5 Installation Guide](docs/Installation_Guide_for_CAI_Pro_v0.5.md) + +### Community Edition Installation + ```bash pip install cai-framework ``` From a780e6812984b4f99b503c1ab4fd54b1fe58443b Mon Sep 17 00:00:00 2001 From: Rufino Cabrera Date: Wed, 29 Oct 2025 15:03:55 +0100 Subject: [PATCH 3/4] Add Homebrew installation step for OS X in CAI Pro v0.5 guide --- docs/Installation_Guide_for_CAI_Pro_v0.5.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/Installation_Guide_for_CAI_Pro_v0.5.md b/docs/Installation_Guide_for_CAI_Pro_v0.5.md index 74db2d14..9a416aa9 100644 --- a/docs/Installation_Guide_for_CAI_Pro_v0.5.md +++ b/docs/Installation_Guide_for_CAI_Pro_v0.5.md @@ -43,6 +43,10 @@ Although we do not provide official support for other operating systems, we offe ### OS X ```bash +# Install homebrew +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + +# Install dependencies brew update && \ brew install git python@3.12 From 09dd7e7bc032ac239c3de1eba342afe6d9086f8f Mon Sep 17 00:00:00 2001 From: Rufino Cabrera Date: Sat, 1 Nov 2025 14:46:16 +0100 Subject: [PATCH 4/4] Add navigation links back to README Install section in CAI Pro guides --- docs/Installation_Guide_for_CAI_Pro_v0.5.md | 6 ++++++ docs/Installation_Guide_for_CAI_Pro_v0.6.md | 10 ++++++++++ 2 files changed, 16 insertions(+) diff --git a/docs/Installation_Guide_for_CAI_Pro_v0.5.md b/docs/Installation_Guide_for_CAI_Pro_v0.5.md index 9a416aa9..8a979de5 100644 --- a/docs/Installation_Guide_for_CAI_Pro_v0.5.md +++ b/docs/Installation_Guide_for_CAI_Pro_v0.5.md @@ -1,5 +1,7 @@ # Installation Guide for CAI Pro v0.5 +← [Back to Installation Guide](../README.md#nut_and_bolt-install) + ## Welcome to CAI Pro! If your subscription is active, you have received a confirmation email. Then, get and save your API-Key and please follow these instructions to install CAI Pro on your system. @@ -131,3 +133,7 @@ cp .env.example .env # edit here your keys/models cai ``` +--- + +**[⬅️ Return to Main Installation Guide](../README.md#nut_and_bolt-install)** + diff --git a/docs/Installation_Guide_for_CAI_Pro_v0.6.md b/docs/Installation_Guide_for_CAI_Pro_v0.6.md index da42a469..f7bc4e3b 100644 --- a/docs/Installation_Guide_for_CAI_Pro_v0.6.md +++ b/docs/Installation_Guide_for_CAI_Pro_v0.6.md @@ -1,5 +1,7 @@ # Installation Guide for CAI Pro v0.6 +← [Back to Installation Guide](../README.md#nut_and_bolt-install) + ## Welcome to CAI Pro! If your subscription is active, you have received a confirmation email. Then, get and save your API-Key and please follow these instructions to install CAI Pro on your system. @@ -45,6 +47,10 @@ Although we do not provide official support for other operating systems, we offe ### OS X ```bash +# Install homebrew +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + +# Install dependencies brew update && \ brew install git python@3.12 @@ -129,3 +135,7 @@ cp .env.example .env # edit here your keys/models cai ``` +--- + +**[⬅️ Return to Main Installation Guide](../README.md#nut_and_bolt-install)** +