Skip to main content

​
Introduction

Experience the power of Heex’s Smart-Data platform! This quick start guide will have you creating your first scenario-driven data collection event in just a few easy steps. Learn how to leverage Agents deployed on your Systems (robots, drones, etc.), to monitor data streams and automatically trigger recordings based on predefined conditions (Triggers). You’ll configure Recorders to capture specific Signals, generating tagged Events that encapsulate key moments and data insights. To make the most of this tutorial, we highly recommend reviewing the Key Concepts, including Smart-Data, Agents, Triggers, Recorders, and the overall architecture. Heex is compatible with Ubuntu, and works great in virtual machines and Docker environments (including WSL).

​
Configure your system

1

Create your first system

The first step is to create a system. Here is how to do it.
Click on the blinking blue dot at each step of the interactive images to explore the application and see how it all comes together.
2

Create a Data Source in the created system

Now that you’ve created your system, you should add a Data Source, to describe what signals you can monitor and record on your system.
3

Create trigger

The next step is to create a trigger, with condition on signals you’ve just created.
4

Request implementation

Now, you can request necessary implementation for the Heex Agent to work and read your systems’ signal. Here, it is fake signals.

​
Configure your SDK

1

Setting Up Your Heex Environment

Get an API key to download and use the cli
  1. Go to Account settings
  2. Create an API key
  3. You can now copy it Account Settings API Key
2

Get the Heex CLI

Download the CLI from this CLI overview page, or perform the following command:
curl --fail -X GET "https://api.app.heex.io/v1/cli/download?operating_system=$(. /etc/os-release && echo ${ID}_${VERSION_ID}_$(uname -m))" \
  -o heex && chmod +x heex
Now you can use the CLI with the heex command. For more details, go to the following page
To facilitate the usage of CLI with API keys, we recommend to login with your API key to create a userconfig for long time use.Multiple userconfig are relevant only when managing multiple workspaces or user access.
3

Get the Heex SDK

Download the Heex SDK with the following command:
heex sdk download --unzip
For more details, go to the following page SDK

​
Generate your first event

1

Code implementations

1. Go to the getStarted Python directory.2. Create monitor
  1. Open the Monitor source file.
  2. Replace the monitorUuid (monitor_uuid in python) variable with the implementation ID of your monitor.
3. Create recorder
  1. Open the recorder source file.
  2. Replace the recorder_uuid variable with the implementation ID you get on the cloud for the recorder.
  3. Add a label: In the generateRequestedLabels function add as many labels as you want as shown by the example.
  4. Add a recording: Create a recording sample by using echo "This is Smart Data!" > file.txt. Provide the path of this file in the generateRequestedFilePaths function (filepath = "/path/get-started/python/file.txt").
2

Update your implementation state

Notify that your implementations are ready to be deployedGo to the web platform and validate your implementations in the developer’s page. Now your system should be in state “To deploy”.
3

Launch the Heex Agent

  • Put all your implementations inside the ~/Heex_SDK_<version>/implementations folder.
  • Launch Heex: 
heex sdk run --path-to-sdk <Heex_SDK> --system-id <SYSTEM_ID>

Congratulations

You have just generated 1 event !
Find your event on the web application, in the Smart Data Events page.