1. Home
  2. Docs
  3. User Guides
  4. Avimesa.js


This guide will walk you through the process of installing Avimesa.js using a shell script, which automatically installs Avimesa.js and its dependencies. A common development scenario would be to run Avimesa Gadget on a Raspberry Pi and the web application (Avimesa Sails) on localhost with Mac or Windows until it’s ready to deploy. For a detailed primer on the Avimesa Sails application please see this document.

Avimesa.js consists of several products:

  • Avimesa.js Web App (Avimesa Sails)
  • Avimesa Gadget
  • Avimesa 1000 Simulator

Pre-requisites for this installation:

  • Machine running Debian Linux or ARM Linux** (Avimesa Gadget currently requires one of these) ** A Raspberry Pi is a great choice
  • Zip file containing Avimesa.js Download here
  • Avimesa.Live account with your API credentials handy


If you haven’t already created your free Avimesa.Live Account click here

Open a terminal window and change into the directory where Avimesa.js-1.0.zip is and run the command unzip Avimesa.js-1.0.zip

Type cd Avimesa.js-1.0 and enter

Run sudo ./install.sh

  • It may take anywhere from 5-15 minutes to install depending on your internet connection
  • This will install NodeJS, SailsJS, Avimesa Gadget and run npm install in order to install all required node_modules to run Avimesa Sails

Run ./changeCredentials.sh

  • Enter your Avimesa Api Key and Avimesa Api Password

Type cd avimesa-sailsjs then enter

Run the following command to launch the Avimesa Sails application:

sails lift

Now, open a second Terminal window

Change directory back to Avimesa.js-1.0 by typing cd ../

Run this command cd Avimesa\ 1000\ Simulator

Then run the following command to launch the Avimesa 1000 Simulator”

node index.js

Open two browser windows and navigate to one of the following:

  • on SSH to Pi – your_ip_address:8080 in one window and your_ip_address:1337 in another, or:
  • on Debian/Desktop – localhost:8080 in one window and localhost:1337 in the other

You should now have two browser windows open. The window running port 1337 should look like this, running Avimesa Sails:

And the window running port 8080 should look like this, running the Avimesa 1000 Simulator:

In the Avimesa Sails window (port 1337), login with:

  • Username: admin@example.com

  • Password: abc123

Go to Devices and click on the Device ID with which you want to send data from

Click on Add Sensor on top right of sensors info

Add a new Amp (AC) sensor on channel 1 with min reading 0 and max 5

Add a new Temp (Fahrenheit) sensor on channel 2 with min reading 0 and max 300

On the Avimesa 1000 Simulator web page (port 8080), Enter Device ID and Authcode for that device and how many messages per DELAY seconds you want to send and click Run

Click on a sensor that you added to view a chart of the sensor data you sent. You should now see a chart with data that looks something like this:

IoT temperature data chart

Note: You may install the apps individually without the Avimesa.js installer script. For instructions see the following:

Installing Avimesa Sails

Installing Avimesa Gadget