Development Computer Setup

Install the CLI

The first step to using the alwaysAI platform is to get your development computer set up with the alwaysAI Command-Line Interface (CLI). Choose your operating system below to get started:

The alwaysAI desktop software includes everything you need to create alwaysAI computer vision applications on your development host.



Note: If you get a security warning, follow the instructions on the FAQ page.

To verify that the alwaysAI CLI is fully installed and accessible, open a Powershell terminal and run:

$ aai -v

This should print a version string like 0.5.30.

Note: WSL and WSL 2 are not currently supported. Both do not have access to HW devices such as cameras and USB peripherals such as the Intel NCS2. Powershell is our recommended terminal on Windows.

OpenSSH

Note: You can skip this step if you don’t plan to install on a remote device.

OpenSSH is a suite of secure networking utilities based on the Secure Shell (SSH) protocol. The alwaysAI CLI relies on OpenSSH for connecting to your edge device and related tasks like key generation. To check if your computer has OpenSSH installed already, open a terminal and enter:

$ ssh -V

This should print a version string like OpenSSH_7.9p1, LibreSSL 2.7.3. As of late 2018, Windows 10 supports OpenSSH out of the box. Check out this article on the Microsoft docs site for more information on installing OpenSSH on Windows.

Node.js

Node.js is an open-source cross-platform JavaScript run-time environment. To check if your development computer has Node.js installed already, open a terminal and enter:

$ node -v

This should print a version string like v12.5.0. The alwaysAI CLI requires Node.js v8.0.0 or greater and npm v5.0.0 or greater. Node.js ships with npm, a package manager that we’ll use to install the alwaysAI CLI.

To install Node.js, visit https://nodejs.org/ and follow the instructions for your operating system.

alwaysAI CLI

To install the alwaysAI CLI, open a terminal on your development machine and run:

$ sudo npm install --global alwaysai

Enter your user’s operating system password when prompted.

To verify that the alwaysAI CLI is fully installed and accessible, run:

$ aai -v

This should print a version string like 0.5.30.

OpenSSH

Note: You can skip this step if you don’t plan to install on a remote device.

OpenSSH is a suite of secure networking utilities based on the Secure Shell (SSH) protocol. The alwaysAI CLI relies on OpenSSH for connecting to your edge device and related tasks like key generation. To check if your computer has OpenSSH installed already, open a terminal and enter:

$ ssh -V

This should print a version string like OpenSSH_7.9p1, LibreSSL 2.7.3. Most Linux distributions already have OpenSSH installed out of the box.

Docker

Note: You can skip this step if you don’t plan to install locally on your development machine.

The edgeIQ runtime is is available in the alwaysAI edgeIQ docker images. To run an alwaysAI application on your Linux host machine, follow instructions specific to your OS. In order for the alwaysAI CLI to run docker, you'll need to add the "docker" group to your user:

$ sudo usermod -aG docker $USER

Once you've done that, test your docker installation with:

$ docker run hello-world

The alwaysAI desktop software includes everything you need to create alwaysAI computer vision applications on your development host.



Note: If you get a security warning, follow the instructions on the FAQ page.

To verify that the alwaysAI CLI is fully installed and accessible, open a terminal and run:

$ aai -v

This should print a version string like 0.5.30.

OpenSSH

Note: You can skip this step if you don’t plan to install on a remote device.

OpenSSH is a suite of secure networking utilities based on the Secure Shell (SSH) protocol. The alwaysAI CLI relies on OpenSSH for connecting to your edge device and related tasks like key generation. To check if your computer has OpenSSH installed already, open a terminal and enter:

$ ssh -V

This should print a version string like OpenSSH_7.9p1, LibreSSL 2.7.3. Although MacOS has OpenSSH installed out of the box, you can update or re-install it with package managers such as Homebrew.