Экспорт и развертывание Axelera AI#
Ultralytics сотрудничает с Axelera AI для обеспечения высокой производительности и энергоэффективности инференса на устройствах Edge AI. Экспортируй и развертывай модели Ultralytics YOLO напрямую на Metis® AIPU, используя Voyager SDK.
Axelera AI обеспечивает специализированное аппаратное ускорение для computer vision на периферии, используя проприетарную архитектуру потока данных и in-memory computing для достижения производительности до 856 TOPS при низком энергопотреблении.
Выбор подходящего оборудования#
Axelera AI предлагает различные форм-факторы для соответствия разным ограничениям развертывания. Приведенная ниже таблица поможет определить оптимальное оборудование для твоего развертывания Ultralytics YOLO.
graph TD
A[Start: Select Deployment Target]:::start --> B{Device Type?}:::decide
B -->|Edge Server / Workstation| C{Throughput Needs?}:::decide
B -->|Embedded / Robotics| D{Space Constraints?}:::decide
B -->|Standalone / R&D| E[Dev Kits & Systems]:::proc
C -->|Max Density <br> 30+ Streams| F[**Metis PCIe x4**<br>856 TOPS]:::out
C -->|Standard PC <br> Low Profile| G[**Metis PCIe x1**<br>214 TOPS]:::out
D -->|Drones & Handhelds| H[**Metis M.2**<br>2280 M-Key]:::out
D -->|High Performance Embedded| I[**Metis M.2 MAX**<br>Extended Thermal]:::out
E -->|ARM-based All-in-One| J[**Metis Compute Board**<br>RK3588 + AIPU]:::out
E -->|Prototyping| K[**Arduino Portenta x8**<br>Integration Kit]:::out
click F "https://store.axelera.ai/"
click G "https://store.axelera.ai/"
click H "https://store.axelera.ai/"
click J "https://store.axelera.ai/"
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef decide fill:#FF9800,color:#fff
classDef out fill:#9C27B0,color:#fffАппаратное портфолио#
Аппаратная линейка Axelera оптимизирована для запуска Ultralytics YOLO26 и более ранних версий с высокой эффективностью FPS на ватт.
Карты-ускорители#
Эти платы обеспечивают ускорение ИИ на существующих хост-устройствах, способствуя brownfield deployments.
| Продукт | Форм-фактор | Вычисления | Производительность (INT8) | Целевое приложение |
|---|---|---|---|---|
| Metis PCIe x4 | PCIe Gen3 x16 | 4x Metis AIPUs | 856 TOPS | Высокоплотная video analytics, умные города |
| Metis PCIe x1 | PCIe Gen3 x1 | 1x Metis AIPU | 214 TOPS | Промышленные ПК, розничная queue management |
| Metis M.2 | M.2 2280 M-Key | 1x Metis AIPU | 214 TOPS | Drones, робототехника, портативные медицинские устройства |
| Metis M.2 MAX | M.2 2280 | 1x Metis AIPU | 214 TOPS | Среды, требующие продвинутого терморегулирования |
Интегрированные системы#
Для готовых решений Axelera сотрудничает с производителями, предоставляя системы, предварительно проверенные для Metis AIPU.
- Metis Compute Board: Автономное периферийное устройство, объединяющее Metis AIPU с ARM CPU Rockchip RK3588.
- Рабочие станции: Корпоративные башни от Dell (Precision 3460XE) и Lenovo (ThinkStation P360 Ultra).
- Промышленные ПК: Защищенные системы от Advantech и Aetina, разработанные для manufacturing automation.
Поддерживаемые задачи#
Оценка глубины не поддерживается: голова глубины порождает операторы, которые компилятор Metis AIPU не может понизить. Сегментация YOLO26 также не поддерживается Ultralytics export, но все же может быть развернута через Voyager SDK, как описано ниже.
Сегментация YOLO26 пока не поддерживается через команду Ultralytics export. Пользователи, которым нужен YOLO26-seg, могут выполнить развертывание через Voyager SDK, используя deploy.py, что предоставляет обходной путь на уровне пользователя. Нативная поддержка компилятора будет добавлена в будущих релизах.
Установка#
Для экспорта в формат Axelera требуется:
- Операционная система: Только Linux (рекомендуется Ubuntu 22.04/24.04)
- Оборудование: Ускоритель Axelera AI (устройства Metis)
- Python: Версии 3.10, 3.11, 3.12 и 3.13
- Системная зависимость:
sudo apt install libgl1(требуется для OpenCV, не включается черезpip)
Установка Ultralytics#
pip install ultralyticsПодробные инструкции см. в нашем руководстве по установке Ultralytics. Если у тебя возникли трудности, обратись к нашему руководству по частым проблемам.
Установка драйвера Axelera#
-
Добавь ключ репозитория Axelera:
sudo sh -c "curl -fsSL https://software.axelera.ai/artifactory/api/security/keypair/axelera/public | gpg --dearmor -o /etc/apt/keyrings/axelera.gpg" -
Добавь репозиторий в apt:
Выбери подходящий фрагмент кода ниже, соответствующий используемой ОС.
# Ubuntu 22.04 sudo sh -c "echo 'deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source ubuntu22 main' > /etc/apt/sources.list.d/axelera.list"# Ubuntu 24.04 sudo sh -c "echo 'deb [signed-by=/etc/apt/keyrings/axelera.gpg] https://software.axelera.ai/artifactory/axelera-apt-source ubuntu24 main' > /etc/apt/sources.list.d/axelera.list" -
Установи SDK и загрузи драйвер:
sudo apt update sudo apt install -y metis-dkms=1.5.5 sudo modprobe metis
Драйвер ядра устанавливается отдельно от пакетов Python SDK, поэтому после обновления SDK (например, с 1.6 до 1.7) необходимо установить соответствующую версию драйвера. Несогласованный драйвер делает устройство недоступным: axdevice сообщает требуемую версию и не может открыть устройство.
[libaxldev.c:285] Found kernel driver version 1.4.16, but at least version 1.4.18 is required. Please update the kernel driver
ERROR: AXR_ERROR_CONNECTION_ERROR: Failed to open device metis-0:4:0Установи версию драйвера, которая соответствует твоему SDK — см. Шаг 3: Установка драйвера ядра Metis. Если на Ubuntu уже запущен более ранний SDK, обнови драйвер и перезагрузи модуль ядра (перезагрузка не требуется):
sudo apt update
sudo apt install -y metis-dkms=1.5.5
sudo rmmod metis
sudo modprobe metisЗатем заново запусти axdevice, чтобы подтвердить обнаружение устройства.
Первый запуск yolo export format=axelera или yolo predict с моделью Axelera автоматически загрузит и установит пакеты Axelera SDK. Это может занять несколько минут в зависимости от скорости соединения, и во время загрузки индикатор выполнения не отображается. Чтобы установить вручную заранее:
pip install axelera-devkit==1.7.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simple
pip install axelera-rt==1.7.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simpleЭкспорт моделей YOLO в Axelera#
Формат Axelera поддерживает режимы Export, Predict и Validate. Инференс и валидация выполняются на аппаратном обеспечении Axelera Metis AIPU. Экспортируй модель, затем загрузи экспортированную модель для запуска инференса или проверки ее точности.
from ultralytics import YOLO
# Load a YOLO26 model
model = YOLO("yolo26n.pt")
# Export the model to Axelera format
model.export(format="axelera") # creates 'yolo26n_axelera_model'from ultralytics import YOLO
# Load the exported Axelera model
model = YOLO("yolo26n_axelera_model")
# Run inference
results = model("https://ultralytics.com/images/bus.jpg")from ultralytics import YOLO
# Load the exported Axelera model
model = YOLO("yolo26n_axelera_model")
# Validate accuracy on the COCO8 dataset
metrics = model.val(data="coco8.yaml")Компилятор Axelera требует numpy<2. Если в твоей среде установлен numpy>=2, первый yolo export автоматически понизит его версию, но экспорт завершится неудачно из-за устаревшего состояния модуля. Просто запусти ту же команду экспорта снова — она завершится успешно со второй попытки.
Аргументы экспорта#
| Аргумент | Тип | По умолчанию | Описание |
|---|---|---|---|
format | str | 'axelera' | Целевой формат для оборудования Axelera Metis AIPU. |
imgsz | int или tuple | 640 | Размер изображения для входа модели. |
batch | int | 1 | Указывает размер пакета для пакетного инференса экспортированной модели или максимальное количество изображений, которые экспортированная модель будет обрабатывать одновременно в режиме predict. |
quantize | int или str | 8/auto | Точность квантования. Требуется 8 (INT8), который включается автоматически для Axelera AIPU. Заменяет устаревшие флаги half/int8. См. квантование INT8. |
data | str | None | YAML-файл датасета калибровки; для классификации вместо этого используется директория датасета или встроенное имя датасета. Если параметр опущен, Ultralytics выбирает датасет калибровки, специфичный для конкретной задачи. |
fraction | float, int или list | 1.0 | Калибровочный поднабор в виде коэффициента, количества изображений или [train, val] коэффициентов/количеств; список ограничивает train или val, в то время как test остается полным (рекомендуется 100-400 изображений). |
device | str | None | Устройство экспорта: GPU (device=0) или CPU (device=cpu). |
Все варианты экспорта см. в документации по режиму экспорта.
Структура вывода#
yolo26n_axelera_model/
├── yolo26n.axm # Axelera model file
├── compiler_config_final.toml # Compiler configuration used for the build
└── metadata.yaml # Model metadata (classes, image size, etc.)Бенчмарки Axelera AI#
Metis AIPU максимизирует пропускную способность при минимизации энергопотребления.
| Модель | Metis PCIe FPS (кадров в секунду) | Metis M.2 FPS (кадров в секунду) |
|---|---|---|
| YOLOv8n | 847 | 771 |
| YOLO11n | 746 | 574 |
| YOLO26n | 648.6 | 484.9 |
Бенчмарки основаны на данных Axelera AI. Фактический FPS зависит от размера модели, пакетирования и входного разрешения.
Применение в реальных условиях#
Ultralytics YOLO на оборудовании Axelera открывает возможности для продвинутых периферийных вычислительных решений:
- Умный ритейл: Object counting в реальном времени и heatmap analytics для оптимизации магазина.
- Промышленная безопасность: Низкозадержечное PPE detection в производственных средах.
- Аналитика дронов: Высокоскоростное object detection на БПЛА для agriculture и поисково-спасательных операций.
- Системы движения: Периферийное license plate recognition и speed estimation.
Рекомендуемый рабочий процесс#
- Обучай (Train) свою модель с помощью режима обучения Ultralytics
- Экспорт в формат Axelera с помощью
model.export(format="axelera") - Проверяй (Validate) точность с помощью
yolo val, чтобы убедиться в минимальной потере качества при квантовании - Предсказывай (Predict) с помощью
yolo predictдля качественной проверки - Развертывание в высокопроизводительный сквозной пайплайн без зависимости от PyTorch — см. примеры использования YOLO в Voyager SDK для составных конвейеров Python с использованием
axelera-rt
Проверка работоспособности устройства#
Проверь, что твое устройство Axelera функционирует правильно:
# if axdevice cannot be found, please run at least one inference (see above) to ensure the required packages are installed
axdeviceПодробную диагностику см. в документации по AxDevice.
Максимальная производительность#
Эта интеграция использует одноядерную конфигурацию для совместимости. Для промышленного использования, требующего максимальной пропускной способности, Axelera Voyager SDK предлагает:
- Использование нескольких ядер (четырехъядерный Metis AIPU)
- Потоковые конвейеры логического вывода
- Тайловый логический вывод для камер с более высоким разрешением
См. model-zoo для получения бенчмарков FPS или свяжись с Axelera для получения производственной поддержки.
Известные проблемы#
- Ограничения питания M.2: Большие или очень большие модели могут вызывать ошибки во время выполнения на ускорителях M.2 из-за ограничений блока питания.
Для получения поддержки посети сообщество Axelera.
FAQ#
Voyager SDK поддерживает экспорт моделей YOLOv8, YOLO11 и YOLO26. См. Supported Tasks для информации о доступности задач для каждой модели.
Да. Любая модель, обученная с использованием Ultralytics Train Mode, может быть экспортирована в формат Axelera при условии использования поддерживаемых слоев и операций.
Voyager SDK от Axelera автоматически квантует модели для архитектуры AIPU смешанной точности. Для большинства задач object detection прирост производительности (более высокий FPS, меньшее энергопотребление) значительно перевешивает минимальное влияние на mAP. Квантование занимает от нескольких секунд до нескольких часов в зависимости от размера модели. Запусти
yolo valпосле экспорта, чтобы проверить точность.Мы рекомендуем от 100 до 400 изображений. Более 400 изображений не дают дополнительных преимуществ и увеличивают время квантования. Поэкспериментируй со 100, 200 и 400 изображениями, чтобы найти оптимальный баланс.
SDK, драйверы и инструменты компилятора доступны через портал разработчиков Axelera.