Installation
This Edge Impulse CLI is used to control local devices, act as a proxy to synchronise data for devices that don't have an internet connection, and to upload and convert local files. The CLI consists of seven tools:
edge-impulse-daemon - configures devices over serial, and acts as a proxy for devices that do not have an IP connection.
edge-impulse-uploader - allows uploading and signing local files.
edge-impulse-data-forwarder - a very easy way to collect data from any device over a serial connection, and forward the data to Edge Impulse.
edge-impulse-run-impulse - show the impulse running on your device.
edge-impulse-blocks - create organizational transformation, custom dsp, custom deployment and custom transfer learning blocks.
himax-flash-tool - to flash the Himax boards and microcontrollers.
Connect to devices without the CLI? Recent versions of Google Chrome and Microsoft Edge can connect directly to fully-supported development boards, without the CLI. See this blog post for more information.
Installation - Windows
Create an Edge Impulse account.
Install Python 3 on your host computer.
Install Node.js v20 or above on your host computer.
For Windows users, install the Additional Node.js tools (called Tools for Native Modules on newer versions) when prompted.
Install the CLI tools via:
You should now have the tools available in your PATH.
Installation - Linux, Ubuntu, MacOS, and Raspbian OS
Create an Edge Impulse account.
Install Python 3 on your host computer.
Install Node.js v20 or above on your host computer.
Alternatively, run the following commands:
The last command should return the node version, v20 or above.
Let's verify the node installation directory:
If it returns /usr/local/, run the following commands to change npm's default directory:
On MacOS you might be using zsh as default, so you will want to update the correct profile
Install the CLI tools via:
You should now have the tools available in your PATH.
Troubleshooting
If you have issues installing the CLI you can also collect data from fully-supported development boards directly using recent versions of Google Chrome and Microsoft Edge. See this blog post on how to get started.
Error: Could not locate the bindings file. (Windows)
This error indicates an issue occurred when installing the edge-impulse-cli for the first time or you have not selected to install the addition tools when installing NodeJS (not selected by default).
Remove NodeJS and install it again selecting the option:
Re-install the CLI via
Tools version "2.0" is unrecognized (Windows)
If you receive the following error: The tools version "2.0" is unrecognized. Available tools versions are "4.0"
, launch a new command window as administrator and run:
EACCES: permission denied, access '/usr/local/lib/node_modules' (macOS)
This is indication that the node_modules
is not owned by you, but rather by root. This is probably not what you want. To fix this, run:
EACCES user "nobody" does not have permission to access the dev dir (Linux)
Try to set the npm user to root and re-run the installation command. You can do this via:
Error: Can’t find Python executable (Windows)
If you receive an error such as:
You're running an older version of node-gyp
(a way to build binary packages). Upgrade via:
The module XXX was compiled against a different Node.js version
This error occurs when you have upgraded Node.js since installing the Edge Impulse CLI. Re-install the CLI via:
Which will rebuild the dependencies.
Error: "gyp: No Xcode or CLT version detected!" (macOS)
This can happen even though you have Xcode CLT installed if you've updated macOS since your install. Follow this guide to reinstall Xcode CLT.
Failed to authenticate with Edge Impulse read ECONNRESET
If you see this error message and you're behind a proxy you will need to set your proxy settings via:
Windows
macOS, Linux
ENOENT: no such file or directory, access ‘~/.npm-global/lib/node_modules/edge-impulse-cli’ (Linux)
Manually delete the Edge Impulse directory from node_modules
and reinstall:
Last updated