ascendai/cann

Atlas CANN

English | 中文

Quick Reference

• CANN is maintained by the CANN community

• Where to get help

  • AtlasHub Image Repository
  • CANN Documentation
  • Atlas Developer Community
  • https://github.com/Ascend/cann-container-image/issues

---

CANN

CANN (Compute Architecture for Neural Networks) is a heterogeneous computing architecture launched by Huawei for AI scenarios. It provides comprehensive software stack support for Atlas AI processors, covering operator libraries, graph engines, runtime libraries, and compilation toolchains.

---

Supported Tags and Dockerfile Links

Tag Format

Tags follow this format:

<cann-version>-<chip-series>-<os>-<python-version>

CANN 9.0.0

CANN-devel 9.0.0

---

Quick Start

Prerequisites (Optional)

Install Driver

An Atlas NPU driver compatible with the CANN version inside the container must be installed on the host. Refer to the CANN Compatibility Matrix for driver and CANN version correspondence.

---

Run a CANN Container

bash
docker run \
    --name cann_container \
    --device /dev/davinci1 \
    --device /dev/davinci_manager \
    --device /dev/devmm_svm \
    --device /dev/hisi_hdc \
    -v /usr/local/dcmi:/usr/local/dcmi \
    -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
    -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ \
    -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info \
    -v /etc/ascend_install.info:/etc/ascend_install.info \
    -it {cann_tag}:latest bash

How to Build Locally

bash
docker buildx build -t {cann_tag} -f {your_repo}/cann/{cann_tag}/Dockerfile .

How to Extend the Image

bash
# Use the CANN image as the base image and add your own software on top
FROM quay.io/ascend/cann:9.0.0-a3-ubuntu22.04-py3.11

RUN apt update -y && \
    apt install gcc ...

...

---

Supported Hardware

---

License

View the license information for CANN and Mind series software included in these images.

As with all container images, pre-installed packages (Python, system libraries, etc.) may be subject to their own licenses.