Troubleshooting


Installation/Startup Errors

Startup gets stuck on step 6/7

This can be caused by a failed Python installation.

Solution: Check your antivirus for a Conda or _Conda process. You may need to whitelist this process. It can be confirmed with the following error message in the runtime.logs file:

level=ERROR msg="Python setup failed! Will be unable to run flows" error="unable to install python 3.10"

Startup gets stuck on step 6/7 or 7/7

This can be also be caused by rogue Runtime processes.

Solution: Check activity monitor for an agent or webai-node process. Manually close those processes and try running Navigator again.

XCode needs to be installed

While the installation of XCode CommandLine Tools will be triggered by our runtime agent upon first run if it is not already installed, you can preemptively install this yourself by following the steps below. If you have already used your machine for software development, it is likely that this is already set up on your machine.

  1. Open Terminal, Cmd+Space - enter "Terminal"
  2. Run this command: xcode-select --install
  3. GUI will open, click "Install"
  4. Accept EULA and let it install. Can take a few minutes
  5. Once it is done, in Terminal run: xcode-select -p
  6. You should see /Library/Developer/CommandLineTools
  7. You are ready.

Flow/Element Errors

The object detection element fails abruptly with no error message and all settings correct

Solution: The dataset is formatted incorrectly. Annotations must be done in COCO JSON format and named annotations.json. There must be an images folder that contains all of the images.