Implementation:Intel Ipex llm Env Check Linux

Knowledge Sources	Intel IPEX-LLM
Domains	Environment_Validation, Diagnostics, Linux
Last Updated	2026-02-09 04:00 GMT

Overview

Concrete tool for comprehensive Linux environment validation covering Python dependencies, hardware, GPU drivers, and Intel XPU stack.

Description

This bash script performs a thorough environment audit for Linux systems running IPEX-LLM. It validates Python version (>=3.9), checks dependency versions (transformers, PyTorch, IPEX-LLM, IPEX), inspects hardware (CPU via lscpu, memory via dmidecode, GPU via lspci), verifies Intel XPU stack components (xpu-smi, SYCL, OpenCL), and reports driver versions for Intel Arc/Data Center GPUs. Each check runs independently with clear section headers.

Usage

Use this as the primary diagnostic tool when setting up or troubleshooting IPEX-LLM on Linux. It covers all aspects of the deployment stack from Python packages to hardware drivers and is the Linux counterpart to check.py for Windows.

Code Reference

Source Location

• Repository: Intel IPEX-LLM
• File: python/llm/scripts/env-check.sh
• Lines: 1-226

Signature

check_python()      # Validate Python >= 3.9
check_transformers() # Report transformers version
check_torch()       # Report PyTorch version
check_ipex_llm()    # Report ipex-llm version
check_cpu_info()    # Display CPU specs via lscpu
check_mem_info()    # Report memory type and size
check_ulimit()      # Display resource limits
check_os()          # Show OS information
check_env()         # Print environment variables
check_xpu_smi_install()  # Validate xpu-smi
check_xpu_smi()     # Run xpu-smi discovery
check_ipex()        # Report IPEX version
check_xpu_info()    # GPU info via lspci
check_linux_kernel_version()  # Kernel info
check_xpu_driver()  # XPU driver version
check_OpenCL_driver()  # OpenCL driver info
check_driver_package()  # Intel driver packages
check_igpu()        # Detect integrated GPU
check_gpu_memory()  # GPU memory from lspci
main()              # Orchestrate all checks

Import

# Standalone script; run via:
# bash env-check.sh

I/O Contract

Inputs

Name	Type	Required	Description
(none)	—	—	No inputs; inspects current system

Outputs

Name	Type	Description
Environment report	Console	Comprehensive system audit report

Usage Examples

Run Linux Environment Check

bash env-check.sh
# Or with sudo for memory type detection:
sudo bash env-check.sh

Related Pages

• Environment:Intel_Ipex_llm_Linux_XPU_Environment