Intel® Distribution for Python*🔗

Intel® Distribution for Python* enhances performance and can improve your program speed from 10 to 100 times faster. It is a Python* distribution that includes the Intel® Math Kernel Library (oneMKL) and other Intel performance libraries to enable near-native performance through acceleration of core numerical and machine learning packages.

Intel® Distribution for Python* is also available for Intel® dGPUs, that include the latest Intel® dGPU drivers and Intel® OneAPI runtime libraries such as Intel® Math Kernel Library, Intel® DPC++ Compiler Library and Intel® Collective Communications Library that enable Machine Learning frameworks leverage the XPU device plugin.

Images🔗

The images below include variations for only the core packages in the Intel® Distribution for Python* installation, or all of the packages.

Tag(s)	IDP
`3.10-full`, `latest`	`2024.2.0`
`3.10-core`	`2024.2.0`
`3.10-xpu-core`	`2024.2.1`
`3.10-xpu-full`	`2024.2.1`

Run a Performance Sample🔗

To run a performance sample run the following commands:

git clone https://github.com/intel/ai-containers
cd ai-containers/python
docker run --rm -it \
    -v $PWD/tests:/tests \
    intel/python:latest \
    python /tests/perf_sample.py

Compare the results against stock python🔗

In the previous command, you should see a result at the bottom like: Time Consuming: 0.03897857666015625. We can compare this against python:3.11-slim-bullseye

# Use the working directory from the above command
docker run --rm -it \
    -v $PWD/tests:/tests \
    python:3.10-slim-bullseye \
    bash
pip install numpy
python /tests/perf_sample.py

Run a Sanity test using the XPU variant🔗

Use the following command to check the availability of Intel dGPU devices on your system and the presence of Intel® OneAPI runtime libraries.

# Use the working directory from the first command
docker run --rm -it \
    -v $PWD/tests:/tests \
    --device /dev/dri \
    intel/python:3.10-xpu-full \
    bash /tests/xpu_base_layers_test.sh

Build from Source (Advanced)🔗

To build the images from source, clone the AI Containers repository, follow the main README.md file to setup your environment, and run the following command:

cd python
docker compose build idp
docker compose run idp

To build the xpu variant of the image, run the following commands:

cd python
docker compose build xpu
docker compose run xpu

You can find the list of services below for each container in the group:

Service Name	Description
`idp`	Base image with Intel® Distribution for Python*
`pip`	Equivalent python image without Intel® Distribution for Python*
`xpu`	Base Image for Intel XPU plugin with Intel® Distribution for Python*

License🔗

View the License for the [Intel® Distribution for Python].

It is the image user's responsibility to ensure that any use of The images below comply with any relevant licenses for all software contained within.

* Other names and brands may be claimed as the property of others.