How to Deploy a Model to the Edge

📘

Before deploying a model to your edge device the following dependencies must be met

• ARM or x86 CPU
• Linux or Unix operating system
• Docker
• Enough storage and memory to load and run your chosen models

If you've already created a device group and generated a device token you're ready to deploy a model to the edge.

You can either do this automatically using wget or with a manual download.

Automatic device connection (via wget)

Go to your device group page and click on the Device Tokens tab on the left hand side of the page.

Next, select the Device type for the edge device to which you'll be deploying your model. It's important to choose an option that matches your device's chip set type (e.g. ARM vs. x86). Finally, click the Generate Commands button, which will display a set of three commands on your screen.

🚧

wget URLs are time-sensitive

The wget download URL expires after 10 minutes, so be quick!

The commands that appear can be copied, as you'll need to run them on your edge device to complete the connection.

Finish connection from your edge device

The last step is to run the commands you just generated on the edge device where you'd like to deploy your model(s). To do so, you'll need to:

1. Log in to your edge device
2. Open up a terminal
3. Navigate to the folder where you'd like to install Modzy Core, the executable that provides an API interface for your models
4. Paste the commands you just generated into your terminal window one by one, which should look similar to the example below

wget 'https://trial.app.modzy.com/api/downloads/modzy-core-linux-amd64?token=s.2E9a04ZyX1RNgDS0k9HvIx9g' -O modzy-core
chmod +x modzy-core
./modzy-core server --modzy.url https://trial.app.modzy.com --modzy.token DEVICE_REGISTRATION_TOKEN

In the example above make sure to replace DEVICE_REGISTRTION_TOKEN with a valid, unexpired device token (it will look something like s.mJdlDcCOxE7XyZSlUwTtDvCd)

After running these commands you should see a lot of messages appearing in your terminal. Once the process is complete, you should see the following message in your terminal window:

{"level":"info","ts":1660060262.90605,"caller":"logger/logger.go:41","msg":"Server is listening at :55000"}

This message means that your model(s) has been successfully deployed and is running on port 55000.