> For the complete documentation index, see [llms.txt](https://nx.docs.scailable.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-models-support/importing-models/from-edge-impulse.md).

# From Edge Impulse

Train a model on Edge Impulse and deploy it to an edge device via the AI Manager Cloud.

## About Edge Impulse

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-2807df664aa7a6e81f50b7dd9c270010a073ae4e%2Fedge-impulse-full-logo.svg?alt=media" alt="Edge Impulse logo" width="200"><figcaption></figcaption></figure>

*"Edge Impulse is the leading development platform for machine learning on edge devices, free for developers and trusted by enterprises."* The [Edge Impulse training platform](https://www.edgeimpulse.com) is available online.

## Preliminaries

This guide covers how to train a model on the [Edge Impulse platform](https://edgeimpulse.com) and deploy it to an edge device using the [AI Manager Cloud](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-cloud-ui/introduction.md).

Before you start, make sure you have:

* An edge device with the [AI Manager installed](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-plugin/quick-start/install-server-and-client.md).
* A camera connected as an input source in Nx Meta.
* An Edge Impulse account. Sign up at [Edge Impulse Studio](https://studio.edgeimpulse.com/).
* A trained model on the Edge Impulse platform. See [Training Loop with Edge Impulse](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-plugin/howtos/training-loop-with-edge-impulse.md#step-1-add-model-to-ai-manager-cloud) for the full training walkthrough with screenshots.

## Quick Overview

This guide walks through three steps, once you have a trained model ready:

1. **Import your Edge Impulse model into AI Manager Cloud.** Sync the trained model to your model catalogue.
2. **Deploy and test the model on your edge device.** Assign the model to a device via the [AI Manager Cloud](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-cloud-ui/introduction.md).
3. **Retrain your model.** Collect new training images in the field and repeat the cycle to improve accuracy over time.

## Step 1: Coupling Your Edge Impulse Model With Nx

Open [the admin interface](https://admin.sclbl.nxvms.com/) and log in to AI Cloud. Click the **+** icon in the sidebar and choose **Link an Edge Impulse model**. The dedicated Edge Impulse wizard opens at step 1: enter your API key and project ID.

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-0e71c21f66b3beeb4418da608501449a8eb96b67%2Fcloud-edgeimpulse-link-empty.png?alt=media" alt="Link an edge impulse model wizard showing step 1 with empty API-Key and Project ID
     fields"><figcaption><p>Step 1: enter your Edge Impulse API key and project ID to link your trained model.</p></figcaption></figure>

Your **Project ID** is shown in the project info panel, or as the last number in the URL when you open the project. Your **API key** is found in the Edge Impulse dashboard under API Keys:

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-e98758f613f622e8aeb3c3c6ff1de5d9b246cec5%2Fedge-impulse-copy-api-key.png?alt=media" alt="Edge Impulse dashboard showing the API Keys tab with the Copy button next to the API
     key"><figcaption><p>Edge Impulse API key: found on the dashboard under API Keys.</p></figcaption></figure>

Paste the API key and project ID into the form, then click **Next**.

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-279b62108df0b5119c5e6b6211f7f440f5a298a1%2Fcloud-edgeimpulse-link.png?alt=media" alt="Link an edge impulse model wizard with API key and project ID filled in and the Next
     button active"><figcaption><p>API key and project ID entered: click Next to continue to owner selection.</p></figcaption></figure>

The wizard continues through owner selection, catalogue assignment, and hardware support steps. These work the same as the [generic upload wizard](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-cloud-ui/upload-your-model.md).

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-802d605b1d7d05fb29bcb60552c49433a729804d%2Fcloud-edgeimpulse-owner.png?alt=media" alt="Link an edge impulse model wizard showing the Set an owner tab with an organization
     card"><figcaption><p>Owner tab: choose the organization or channel partner that owns this model.</p></figcaption></figure>

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-a1c3977605f8779ed3d8b061c6431e7ea0a03a58%2Fcloud-edgeimpulse-owner-selected.png?alt=media" alt="Link an edge impulse model wizard showing the owner confirmed and collapsed to Change
     Association"><figcaption><p>Owner confirmed: click Next to continue to catalogue assignment.</p></figcaption></figure>

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-f6c0f227a8dcf348a2ec4d065350dc098569a240%2Fcloud-edgeimpulse-catalogue-empty.png?alt=media" alt="Link an edge impulse model wizard showing the Catalogue tab with an empty search
     field"><figcaption><p>Catalogue tab: search for the catalogue to add this model to.</p></figcaption></figure>

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-2ffea4ebd19ffc8788a7062b11c0fd37029d743b%2Fcloud-edgeimpulse-catalogue.png?alt=media" alt="Link an edge impulse model wizard showing the Object Detection catalogue selected"><figcaption><p>Catalogue selected: click Next to continue to hardware support.</p></figcaption></figure>

On the final step, choose any additional hardware conversions, then click **Link model**.

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-a9a6a0dfe4ee5f164fc824b8d83480e1dad08d05%2Fcloud-edgeimpulse-hardware.png?alt=media" alt="Link an edge impulse model wizard showing step 4 Additional hardware support with
     MemryX checked"><figcaption><p>Step 4: choose hardware conversions, then click Link model to import the model.</p></figcaption></figure>

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-65b7555e2d4ffc1c6e3c0b192728f011829e56ed%2Fcloud-edgeimpulse-detail.png?alt=media" alt="Model link successful notification toast"><figcaption><p>Model link successful: the Edge Impulse model has been imported.</p></figcaption></figure>

When the import completes, you are taken to the model detail page with a confirmation notice.

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-65b7555e2d4ffc1c6e3c0b192728f011829e56ed%2Fcloud-edgeimpulse-detail.png?alt=media" alt="Model detail page showing the imported Edge Impulse model name, description,
     catalogue, and owner information"><figcaption><p>Model detail page: the Edge Impulse model is now in your library and ready to deploy.</p></figcaption></figure>

You are now ready to deploy your model to your selected edge device.

## Step 2: Deploying and Testing Your Model on Your Edge Device

In Nx Meta, connect to your system and open the plugin page.

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-d6c5e63fc4cd2b481d2de3ef843a226aa200ff21%2Fclient-ai-manager-custom-pipeline.png?alt=media" alt="Camera Settings Integrations tab showing the Manage Device button next to the AI Pipeline dropdown set to Custom"><figcaption><p>Click Manage Device to open the model pipeline selector</p></figcaption></figure>

Click "Manage device" and select the model you created.

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-29c77b6d37ccc64d3a5c388165811ab13d397098%2Fpopup-assign-model.png?alt=media" alt="Model assignment popup showing a model in the catalogue with a View Details and Add To Pipeline button"><figcaption><p>Select your Edge Impulse model and click Add to pipeline</p></figcaption></figure>

Click "Add to pipeline". The model is assigned and you return to the plugin settings.

Activate the Objects tab in the camera view. Detection boxes appear on the video feed:

<figure><img src="https://2982163321-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKGfC0TFSmuMDjbpLErO3%2Fuploads%2Fgit-blob-ec4b3146874673737c272a780032d07f2b31a7e6%2Fedge-impulse-detection-boxes.png?alt=media" alt="Camera feed showing bounding boxes drawn over detected objects by the Edge Impulse model"><figcaption><p>Detection boxes appear on the camera feed once the Objects tab is active</p></figcaption></figure>

Your Edge Impulse model is now running on your edge device.

## Step 3: Retraining Your Model

Improve the model over time by collecting new training images in the field, labeling them, and retraining on the updated dataset. See [Training loop with Edge Impulse](https://nx.docs.scailable.net/ai-manager-v6.1.4/ai-manager-plugin/howtos/training-loop-with-edge-impulse.md) for the full step-by-step loop, including postprocessor setup for automatic image uploads and re-deploying the retrained model.
