Getting Started

Requirements

python 3.5+

NAIS make use of async/await language constructs, so python 3.5+ is needed.

Depending on python packages installed on your machine you may need to install the venv package if you plan to configure a virtual sandbox for python:

sudo apt-get install python3-venv

protobuf 3.3.0+

Install protobuf from source or pick up a pre-built binary distribution.

For example:

PROTO_VERSION=3.3.0

curl -OL https://github.com/google/protobuf/releases/download/v${PROTO_VERSION}/protoc-${PROTO_VERSION}-linux-x86_64.zip

unzip -o protoc-${PROTO_VERSION}-linux-x86_64.zip -d ${HOME}/protoc3
rm protoc-${PROTO_VERSION}-linux-x86_64.zip

ser2net

ser2net is used for serial communication:

sudo apt-get install ser2net
sudo systemctl disable ser2net

ser2net service has to be disabled because start/stop of ser2net process is managed by NAIS junction app.

Installation

Get NAIS from github:

1
2
3
4
5
git clone https://github.com/attdona/NAIS
cd NAIS
. nais.env.sh   # do it if you want a dedicated virtualenv
pip install wheel
pip install .

If you feel like modifying NAIS package install it in development mode. Run last step as:

pip install -e .[dev]