Skip to main content

🎥 Your First Inference on Metis with Voyager SDK: Step-by-Step Video Guide

  • June 10, 2025
  • 6 replies
  • 297 views

jonask-ai
Axelera Team

Hey everyone,

Excited to share a brand-new video I put together for anyone getting started with the Metis card and Voyager SDK. Whether you're setting up your eval kit or just curious about how inference works on Metis, this walkthrough is for you.

🛠️ What’s inside:

  • Setting up your environment and verifying camera input
  • Running YOLOv5s-v7-COCO on a live camera stream
  • Using download_prebuilt for faster setup
  • Running inference on media files and datasets
  • Benchmarking performance
  • Measuring accuracy with mAP and more

📺 You can find this tutorial, and more, on our YouTube Channel

This guide is based on SDK version 1.2.5 and follows the official Quick Start Guide, but with some extra tips and tricks to get you up and running even faster.

💬 Have you tried running inference on Metis yet?
Drop your thoughts, questions, or your own setup experiences in the comments, I'd love to hear how it's going for you or help troubleshoot if you're stuck!

See you there,
Jonas

 

6 replies

AlbertaBeef
Cadet
  • Cadet
  • February 24, 2026

Thank you for the great overview video ​@jonask-ai  !
With the latest voyager-sdk (v1.5), the download_prebuilt.py script is not present.
Does this still exist (different name, different location) ?
Cheers !
AlbertaBeef


jonask-ai
Axelera Team
  • Author
  • Axelera Team
  • March 2, 2026

Hi ​@AlbertaBeef, indeed that has been changed, it is now called axdownloadmodel, give it a try and let me know if you need further information about it 👍


  • Cadet
  • March 13, 2026

Hi Jonas, 
I'm testing with the Metis Compute Board, and I cannot open de video of my camera or a mp4 file. 

While opening the USB camera I have the following error: Format undefined 
I can view the camera with other tools on the board and tried to lower the resolution of my camera, but this doesn't help.

While trying to open a mp4 file I have the error message: cannot access video file.
I can open and view this video in other tools without a problem.

Kind Regards,

Johan


Spanner
Axelera Team
Forum|alt.badge.img+3
  • Axelera Team
  • March 13, 2026

Hi there ​@Johan_N ! 

@jonask-ai will know better about this, but a couple of things that might help us narrow things down quickly.

Could you share which Voyager SDK version you're running, and the commands you're using for both the USB camera and the MP4 file? Oh, and the output of v4l2-ctl --list-formats-ext -d /dev/video0 (replacing video0 with whichever device your camera is on)?

The 'Format undefined' error - some cameras only output MJPEG, which can cause this. Although I think the v4l2-ctl output will tell us what formats your camera supports. 👍

For the MP4 file, it sounds like a path issue. Could you confirm the full path you're passing and whether you're running from within the voyager-sdk directory with the venv activated? Also worth checking that the built-in sample videos work, e.g. ./inference.py yolov5s-v7-coco media/traffic1_1080p.mp4 to isolate whether it's specific to your file or a broader problem.

Let me know how it goes!


  • Cadet
  • March 16, 2026

Hi ​@Spanner,

Thank you for your response.

My camera(s) have a standard MJPG format as you can se in the following output:

ubuntu@antelao-3588:~/voyager-sdk$ v4l2-ctl -d /dev/video0 --get-fmt-video
Format Video Capture:
    Width/Height      : 3264/2448
    Pixel Format      : 'MJPG' (Motion-JPEG)
    Field             : None
    Bytes per Line    : 0
    Size Image        : 15980544
    Colorspace        : sRGB
    Transfer Function : Rec. 709
    YCbCr/HSV Encoding: ITU-R 601
    Quantization      : Default (maps to Full Range)
    Flags             :

I changed this to the following settings:

Format Video Capture:
    Width/Height      : 640/480
    Pixel Format      : 'YUYV' (YUYV 4:2:2)
    Field             : None
    Bytes per Line    : 1280
    Size Image        : 614400
    Colorspace        : sRGB
    Transfer Function : Rec. 709
    YCbCr/HSV Encoding: ITU-R 601
    Quantization      : Default (maps to Limited Range)
    Flags             :

only without result.

The mp4 file probably will be a file format problem, only the media/traffic1_1080p.mp4 cannot be found on the default installation of my compute board.


Spanner
Axelera Team
Forum|alt.badge.img+3
  • Axelera Team
  • March 16, 2026

Hi ​@Johan_N 

Thanks for the detail, that's useful. Before we dig further into the camera issue, could you share your SDK version? You can check with cat VERSION from the voyager-sdk directory. There was a known issue with USB camera input on the Compute Board that's been fixed in a recent release, so that'll give us a clue as to whether an update would sort it.

On the MP4, the sample videos aren't pre-installed on the Compute Board. Run ./install.sh --media (with the venv deactivated first) to grab them, and that should get you going with the built-in test files.