Edge Software Catalog
Support for issues related to Edge Software Catalog
474 讨论

[ESQ for AI Edge system] The images.py script failed during testing

AmandaLee
新分销商 I
9,607 次查看

Hi Expert,

 

I encountered an issue while testing with "ESQ for AI Edge system." When I ran the esq run command, the "images.py" failed.

 

OS: Ubuntu 24.04
Platform: MTL 155H
ESQ for AI Edge System version: 11.2.1

2025-06-17-ASRock-NUC.png

Could you please provide any suggestions to help resolve this?

 

Regards,

Amanda

标签 (1)
0 项奖励
1 解答
JesusE_Intel
主持人
8,038 次查看

The issue is caused by conflicts in python packages due to recent changes in 3rd party dependency versions. To resolve this, please apply the following patch.

 

Steps: 

1. Uninstall the ESQ package completely first:

 # Inside the software package location

  • ./edgesoftware uninstall -a
  •  cd ~/
  • sudo rm -rf ~/esq

2. Reinstall the ESQ as usual following the official guide.

3. Ensure that the environment is thoroughly cleaned. Running the command below:

  • docker container prune -f && docker images -q | xargs docker rmi -f
  • docker system prune -f 
  • cd ~/
  • sudo rm -rf .cache

4. Apply the patch file ESQ 11.2.1-Intel AI Edge System that is attached in this comment.

  • Copy the patch file to ~/esq
  • Run "cd ~/esq"
  • Run "patch -p1 < final.patch"
  • Paste "modules/ai-edge-system/genAI/Dockerfile" for the file to patch
  • For the second time it asks, paste "modules/ai-edge-system/genAI/Dockerfile.vllm.ov" for the file to patch.

5. Proceed to the normal ESQ run command. 

 

 

在原帖中查看解决方案

0 项奖励
8 回复数
Zulkifli_Intel
主持人
9,562 次查看

Hi AmandaLee,

Thank you for reaching out.

 

I'm not able to run the Intel ESQ as well:

esq_run.png

esq_error.png

Could you please share the steps you took from installation to running the module?

 

 

Regards,

Zul

 

0 项奖励
AmandaLee
新分销商 I
9,531 次查看

Hi Zull,

I followed the steps on the ESQ for AI Edge system and ESQ get started.

1. Installed a fresh Ubuntu 24.04

system_info.png

2. Prerequisites

$ sudo apt-get install libnuma-dev python3-dev jq

$ export HF_TOKEN=.....

$ ### Set up Docker

docker.png

3. Install ESQ

$ unzip edge_system_qualification.zip 

$ cd edge_system_qualification/

$ chmod +x edgesoftware

$ sudo apt install python3-venv

$ python3 -m venv venv

$ ./edgesoftware install

install.png

4. Run ESQ

$ cd ~/esq

$ esq --verbose run

run_cmd.png

Please refer to the attachments for "esq" and console log.

Thank you.

 

Regards,

Amanda

0 项奖励
Zulkifli_Intel
主持人
9,505 次查看

Hi AmandaLee,

 

Thank you for sharing the logs and steps taken to reproduce the issue. I'll check with the dev team for troubleshooting.

 

 

Regards,

Zul


0 项奖励
JesusE_Intel
主持人
8,932 次查看

Hi AmandaLee,


Thank you for providing the steps you took and log files. Just to confirm, did you install the drivers for your system using the script mentioned in the Getting Started Guide?


https://www.intel.com/content/www/us/en/developer/articles/guide/esq-for-ai-edge-systems.html#inpage-nav-2-undefined


Install the required drivers with the corresponding Intel AI Edge Systems configuration as mentioned in the VRB guidelines. To speed up system driver and library installation, go to Edge Developer Kit Reference Scripts, and then select the appropriate scripts for the target platform. 


Regards,

Jesus



0 项奖励
AmandaLee
新分销商 I
8,864 次查看

Hi Jesus,

 

I have tried Ubuntu 22.04, and after running the Edge Developer Kit Reference Scripts, I encountered the same error when running ESQ.

I know Zul ran into this before, has the issue been fixed? If so, what was the solution?

 

Regards,

Amanda

0 项奖励
JesusE_Intel
主持人
8,039 次查看

The issue is caused by conflicts in python packages due to recent changes in 3rd party dependency versions. To resolve this, please apply the following patch.

 

Steps: 

1. Uninstall the ESQ package completely first:

 # Inside the software package location

  • ./edgesoftware uninstall -a
  •  cd ~/
  • sudo rm -rf ~/esq

2. Reinstall the ESQ as usual following the official guide.

3. Ensure that the environment is thoroughly cleaned. Running the command below:

  • docker container prune -f && docker images -q | xargs docker rmi -f
  • docker system prune -f 
  • cd ~/
  • sudo rm -rf .cache

4. Apply the patch file ESQ 11.2.1-Intel AI Edge System that is attached in this comment.

  • Copy the patch file to ~/esq
  • Run "cd ~/esq"
  • Run "patch -p1 < final.patch"
  • Paste "modules/ai-edge-system/genAI/Dockerfile" for the file to patch
  • For the second time it asks, paste "modules/ai-edge-system/genAI/Dockerfile.vllm.ov" for the file to patch.

5. Proceed to the normal ESQ run command. 

 

 

0 项奖励
AmandaLee
新分销商 I
7,457 次查看

Hi Jesus,

 

Thanks, the patch resolved the issue.

 

Regards,

Amanda

0 项奖励
JesusE_Intel
主持人
6,770 次查看

Thank you for confirming. If you need further assistance, please create a new discussion as this one will no longer be monitored.


0 项奖励
回复