Link to this sectionExportación y despliegue de Axelera AI#
Ultralytics colabora con Axelera AI para permitir una inferencia de alto rendimiento y eficiencia energética en dispositivos de Edge AI. Exporta y despliega modelos Ultralytics YOLO directamente a la Metis® AIPU utilizando el Voyager SDK.
Axelera AI proporciona aceleración de hardware dedicada para visión artificial en el edge, utilizando una arquitectura de flujo de datos patentada y computación en memoria para ofrecer hasta 856 TOPS con un bajo consumo de energía.
Link to this sectionSelección del hardware adecuado#
Axelera AI ofrece varios factores de forma para adaptarse a diferentes limitaciones de despliegue. El siguiente gráfico ayuda a identificar el hardware óptimo para tu despliegue de Ultralytics YOLO.
graph TD
A[Start: Select Deployment Target] --> B{Device Type?}
B -->|Edge Server / Workstation| C{Throughput Needs?}
B -->|Embedded / Robotics| D{Space Constraints?}
B -->|Standalone / R&D| E[Dev Kits & Systems]
C -->|Max Density <br> 30+ Streams| F[**Metis PCIe x4**<br>856 TOPS]
C -->|Standard PC <br> Low Profile| G[**Metis PCIe x1**<br>214 TOPS]
D -->|Drones & Handhelds| H[**Metis M.2**<br>2280 M-Key]
D -->|High Performance Embedded| I[**Metis M.2 MAX**<br>Extended Thermal]
E -->|ARM-based All-in-One| J[**Metis Compute Board**<br>RK3588 + AIPU]
E -->|Prototyping| K[**Arduino Portenta x8**<br>Integration Kit]
click F "https://store.axelera.ai/"
click G "https://store.axelera.ai/"
click H "https://store.axelera.ai/"
click J "https://store.axelera.ai/"Link to this sectionCartera de hardware#
La línea de hardware de Axelera está optimizada para ejecutar Ultralytics YOLO26 y versiones anteriores con una alta eficiencia de FPS por vatio.
Link to this sectionTarjetas aceleradoras#
Estas tarjetas permiten la aceleración de IA en dispositivos host existentes, facilitando los despliegues en entornos existentes.
| Producto | Factor de forma | Cómputo | Rendimiento (INT8) | Aplicación objetivo |
|---|---|---|---|---|
| Metis PCIe x4 | PCIe Gen3 x16 | 4x Metis AIPUs | 856 TOPS | Analítica de vídeo de alta densidad, ciudades inteligentes |
| Metis PCIe x1 | PCIe Gen3 x1 | 1x Metis AIPU | 214 TOPS | PCs industriales, gestión de colas en retail |
| Metis M.2 | M.2 2280 M-Key | 1x Metis AIPU | 214 TOPS | Drones, robótica, dispositivos médicos portátiles |
| Metis M.2 MAX | M.2 2280 | 1x Metis AIPU | 214 TOPS | Entornos que requieren una gestión térmica avanzada |
Link to this sectionSistemas integrados#
Para soluciones integrales, Axelera colabora con fabricantes para proporcionar sistemas prevalidos para la Metis AIPU.
- Metis Compute Board: Un dispositivo edge autónomo que combina la Metis AIPU con una CPU ARM Rockchip RK3588.
- Estaciones de trabajo: Torres empresariales de Dell (Precision 3460XE) y Lenovo (ThinkStation P360 Ultra).
- PCs industriales: Sistemas robustos de Advantech y Aetina diseñados para automatización de la fabricación.
Link to this sectionTareas compatibles#
Las siguientes tareas son compatibles con los modelos YOLOv8, YOLO11 y YOLO26.
| Tarea | YOLOv8 | YOLO11 | YOLO26 |
|---|---|---|---|
| Detección de objetos | ✅ | ✅ | ✅ |
| Estimación de pose | ✅ | ✅ | ✅ |
| Segmentación de instancias | ✅ | ✅ | ⚠️ Solo Voyager SDK |
| Segmentación semántica | ❌ | ❌ | ✅ |
| Cajas delimitadoras orientadas | ✅ | ✅ | ✅ |
| Clasificación | ✅ | ✅ | ✅ |
La segmentación de YOLO26 aún no es compatible a través del comando export de Ultralytics. Los usuarios que necesiten YOLO26-seg pueden realizar el despliegue mediante el Voyager SDK usando deploy.py, lo que proporciona una solución alternativa a nivel de usuario. El soporte nativo del compilador se añadirá en una futura versión.
Link to this sectionInstalación#
La exportación al formato Axelera requiere:
- Sistema operativo: Solo Linux (se recomienda Ubuntu 22.04/24.04)
- Hardware: Acelerador de Axelera AI (dispositivos Metis)
- Python: Versiones 3.10, 3.11, 3.12 y 3.13
- Dependencia del sistema:
sudo apt install libgl1(requerido por OpenCV, no incluido mediantepip)
Link to this sectionInstalación de Ultralytics#
pip install ultralyticsPara obtener instrucciones detalladas, consulta nuestra guía de instalación de Ultralytics. Si tienes dificultades, consulta nuestra guía de problemas comunes.
Link to this sectionInstalación del controlador de Axelera#
-
Añade la clave del repositorio de Axelera:
sudo sh -c "curl -fsSL https://software.axelera.ai/artifactory/api/security/keypair/axelera/public | gpg --dearmor -o /etc/apt/keyrings/axelera.gpg" -
Añade el repositorio a apt:
Elige el fragmento correspondiente de abajo para que coincida con el SO que estás utilizando.
# 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" -
Instala el SDK y carga el controlador:
sudo apt update sudo apt install -y metis-dkms=1.4.16 sudo modprobe metis
La primera vez que ejecutes yolo export format=axelera o yolo predict con un modelo de Axelera, se descargará e instalará automáticamente el paquete del SDK de Axelera. Esto puede llevar varios minutos dependiendo de la velocidad de tu conexión, y no se muestra el progreso durante la descarga. Para instalarlo manualmente de antemano:
pip install axelera-devkit==1.6.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simple
pip install axelera-rt==1.6.0 --extra-index-url https://software.axelera.ai/artifactory/api/pypi/axelera-pypi/simpleLink to this sectionExportación de modelos YOLO a Axelera#
El formato Axelera es compatible con los modos Export, Predict y Validate. La inferencia y la validación se ejecutan en el hardware Axelera Metis AIPU. Exporta tu modelo y luego cárgalo para ejecutar la inferencia o validar su precisión.
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")El compilador de Axelera requiere numpy<2. Si tu entorno tiene numpy>=2, la primera vez que ejecutes yolo export se reducirá automáticamente la versión, pero la exportación fallará debido al estado obsoleto del módulo. Simplemente vuelve a ejecutar el mismo comando de exportación y tendrá éxito en el segundo intento.
Link to this sectionArgumentos de exportación#
| Argumento | Tipo | Predeterminado | Descripción |
|---|---|---|---|
format | str | 'axelera' | Formato de destino para el hardware Axelera Metis AIPU. |
imgsz | int o tuple | 640 | Tamaño de imagen para la entrada del modelo. |
batch | int | 1 | Especifica el tamaño de inferencia por lote del modelo exportado o el número máximo de imágenes que el modelo procesará simultáneamente en el modo predict. |
int8 | bool | True | Habilita la cuantización INT8 para AIPU. |
data | str | 'coco128.yaml' | Configuración del dataset para la calibración de la cuantización. |
fraction | float | 1.0 | Fracción del dataset para la calibración (se recomiendan entre 100 y 400 imágenes). |
device | str | None | Dispositivo de exportación: GPU (device=0) o CPU (device=cpu). |
Para todas las opciones de exportación, consulta la documentación del modo Export.
Link to this sectionEstructura de salida#
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.)Link to this sectionBenchmarks de Axelera AI#
La Metis AIPU maximiza el rendimiento y minimiza el consumo de energía.
| Modelo | FPS de Metis PCIe (fotogramas por segundo) | FPS de Metis M.2 (fotogramas por segundo) |
|---|---|---|
| YOLOv8n | 847 | 771 |
| YOLO11n | 746 | 574 |
| YOLO26n | 648.6 | 484.9 |
Benchmarks basados en datos de Axelera AI. Los FPS reales dependen del tamaño del modelo, el procesamiento por lotes y la resolución de entrada.
Link to this sectionAplicaciones en el mundo real#
Ultralytics YOLO en hardware Axelera permite soluciones avanzadas de computación edge:
- Smart Retail: Conteo de objetos y análisis de mapas de calor en tiempo real para la optimización de tiendas.
- Seguridad industrial: Detección de EPI de baja latencia en entornos de fabricación.
- Drone Analytics: High-speed object detection on UAVs for agriculture and search-and-rescue.
- Traffic Systems: Edge-based license plate recognition and speed estimation.
Link to this sectionFlujo de trabajo recomendado#
- Entrena tu modelo usando el modo Train de Ultralytics
- Exporta al formato Axelera usando
model.export(format="axelera") - Valida la precisión con
yolo valpara verificar una pérdida de cuantización mínima - Predice usando
yolo predictpara una validación cualitativa - Despliega en una pipeline integral de alto rendimiento sin dependencia de PyTorch; consulta los ejemplos de YOLO en Voyager SDK para pipelines de Python componibles usando
axelera-rt
Link to this sectionComprobación del estado del dispositivo#
Verifica que tu dispositivo Axelera funcione correctamente:
# if axdevice cannot be found, please run at least one inference (see above) to ensure the required packages are installed
axdevicePara diagnósticos detallados, consulta la documentación de AxDevice.
Link to this sectionMáximo rendimiento#
Esta integración utiliza una configuración de un solo núcleo para mayor compatibilidad. Para producción que requiera el máximo rendimiento, el Axelera Voyager SDK ofrece:
- Utilización de múltiples núcleos (Metis AIPU de cuatro núcleos)
- Canalizaciones de inferencia en streaming
- Inferencia en mosaico (tiled) para cámaras de alta resolución
Consulta el model-zoo para ver puntos de referencia de FPS o contacta con Axelera para recibir soporte de producción.
Link to this sectionProblemas conocidos#
- Limitaciones de energía en M.2: Los modelos grandes o extra grandes pueden encontrar errores de tiempo de ejecución en aceleradores M.2 debido a las limitaciones de la fuente de alimentación.
Para recibir soporte, visita la Comunidad de Axelera.
Link to this sectionFAQ#
Link to this section¿Qué versiones de YOLO son compatibles con Axelera?#
El Voyager SDK permite exportar modelos YOLOv8, YOLO11 y YOLO26. Consulta Tareas admitidas para conocer la disponibilidad de tareas por modelo.
Link to this section¿Puedo implementar modelos entrenados a medida?#
Sí. Cualquier modelo entrenado utilizando el Modo de entrenamiento de Ultralytics se puede exportar al formato de Axelera, siempre que utilice capas y operaciones compatibles.
Link to this section¿Cómo afecta la cuantificación INT8 a la precisión?#
El Voyager SDK de Axelera cuantifica automáticamente los modelos para la arquitectura AIPU de precisión mixta. Para la mayoría de las tareas de detección de objetos, las ganancias en rendimiento (más FPS, menor consumo de energía) compensan significativamente el impacto mínimo en el mAP. La cuantificación tarda desde unos segundos hasta varias horas según el tamaño del modelo. Ejecuta yolo val después de la exportación para verificar la precisión.
Link to this section¿Cuántas imágenes de calibración debo usar?#
Recomendamos entre 100 y 400 imágenes. Más de 400 no proporcionan ningún beneficio adicional y aumentan el tiempo de cuantificación. Experimenta con 100, 200 y 400 imágenes para encontrar el equilibrio óptimo.
Link to this section¿Dónde puedo encontrar el Voyager SDK?#
El SDK, los controladores y las herramientas de compilación están disponibles a través del Portal de desarrolladores de Axelera.