Installation¶
Preface¶
As was mentioned [1], you need two pieces of software to use the platform:
- the platform itself;
- and some client application.
This tutorial is mostly related to the platform itself. For details about the installation and usage of client applications, please visit the Client Applications page.
System Requirements¶
Minimum System Requirements:
- Python 3.5 [2]
- bash
Recommended System Requirements:
- Python 3.5 or newer
- UNIX-like operating system (like macOS and Linux-based systems)
- hardware support of protocols like Bluetooth, ZigBee and so on for different Integrations
Automatic Installation Steps¶
- Download an archive with the latest stable release of platform from its repository: https://github.com/s-kostyuk/adpl/releases
Note
You can also download the latest development (unstable) version here: https://github.com/s-kostyuk/adpl by clicking a ‘clone or download’ button.
Extract archive content to some directory. Remember its placement (path).
Open terminal emulator, switch to the everpl’s project directory:
cd /path/to/everpls/directory
Install an everpl package using pip:
pip3 install .
Now it’s possible to run everpl application by simply calling an
everpl
command:everpl
Installation finished!
Note
You can also install everpl package in the “Development Mode”. Why you may need it and what with mode provides is described by the following link: [4]
Manual Installation Steps¶
Download an archive with the latest stable release of platform from its repository: https://github.com/s-kostyuk/adpl/releases
Extract archive content to some directory. Remember its placement (path).
Open terminal emulator, switch to the platform’s directory:
cd /path/to/platforms/directory
Install all needed dependencies that are listed in
requirements.txt
[3] file. The most simple way to do this is to use pip:pip3 install -r requirements.txt
Now it’s possible to run the main execution file:
bash ./dpl/run.sh
Installation finished!
Footnotes
[1] | Documentation page: Getting Started |
[2] | async/await expressions which are commonly used in the platform was introduced only in Python 3.5. In a case if you need a support of older versions of python - please, endorse this issue: #22. |
[3] | Requirements file is placed in the root of platform’s directory, for example: https://github.com/s-kostyuk/adpl/blob/devel/requirements.txt |
[4] | Information about “Development Mode” of package installation process: https://packaging.python.org/tutorials/distributing-packages/#working-in-development-mode |