Skip to main content

Assets & MPK setup

This page describes where tutorials/tests look for model packs (MPKs) and sample assets, and how to provide them locally.

Ensure sima-cli is on PATH​

Some tests invoke sima-cli from non-interactive shells. Use this once after installing sima-cli:

SIMA_CLI_BIN_DIR="<path-to-sima-cli-bin>"
grep -Fqx "export PATH=\"${SIMA_CLI_BIN_DIR}:\$PATH\"" ~/.bashrc || echo "export PATH=\"${SIMA_CLI_BIN_DIR}:\$PATH\"" >> ~/.bashrc
source ~/.bashrc

Then verify:

/bin/sh -c 'command -v sima-cli'

MPK locations and environment variables​

ResNet50​

Search order:

  1. SIMA_RESNET50_TAR (absolute or relative path)
  2. tmp/resnet_50_mpk.tar.gz
  3. Local files moved into tmp/ if found:
    • resnet_50_mpk.tar.gz
    • resnet-50_mpk.tar.gz

Download (if sima-cli is available):

sima-cli modelzoo -v 2.0.0 get resnet_50

YOLOv8 (v8s)​

Search order:

  1. SIMA_YOLO_TAR
  2. tmp/yolo_v8s_mpk.tar.gz
  3. Common local names (moved into tmp/ if found):
    • yolo_v8s_mpk.tar.gz
    • yolo-v8s_mpk.tar.gz
    • yolov8s_mpk.tar.gz
    • yolov8_s_mpk.tar.gz

Download (if sima-cli is available):

sima-cli modelzoo -v 2.0.0 get yolo_v8s

Sample images​

Tutorials ship with sample images under tutorials/assets/. Cpp tutorials resolve image paths in this order:

  1. --image <path> CLI override.
  2. SIMA_NEAT_TUTORIAL_ASSETS env var (directory path).
  3. /usr/share/sima-neat/tutorials/assets/ (DEB install).
  4. /neat-resources/core-src/tutorials/assets/ (eLxr SDK).
  5. <repo>/tutorials/assets/ (source checkout fallback).

The shipped defaults are ilena_488.jpg, fronalpstock_1330.jpg, and lichtenstein_512.png. Test suites may still download additional assets under tmp/ — see their own documentation.

You can override the COCO image URL used by tests with:

SIMA_COCO_URL=<custom_url>

Where tests download to​

Tests and examples generally place downloaded assets under tmp/ in the repo root. Tutorials will skip gracefully if required assets are missing.

Troubleshooting​

  • If a tutorial prints SKIP: missing ..., provide the asset or pass a flag (e.g., --mpk <path>, --image <path>).
  • If sima-cli is unavailable, set the env vars to point to local MPKs.