Como executar o Ultralytics YOLO26 num Raspberry Pi com um Coral Edge TPU#
Um Raspberry Pi é uma plataforma econômica e energeticamente eficiente para executar visão computacional no edge, mas a inferência no dispositivo é lenta mesmo com formatos otimizados como ONNX ou OpenVINO. Emparelhar o Pi com um coprocessador Coral Edge TPU descarrega a inferência para hardware dedicado e a acelera drasticamente. Este guia mostra como instalar o tempo de execução, exportar um modelo Ultralytics YOLO26 para o formato Edge TPU e executar inferência acelerada.
Watch: How to Run Inference on Raspberry Pi using Google Coral Edge TPU
Por que usar um Coral Edge TPU?#
O Coral Edge TPU é um dispositivo compacto que adiciona um coprocessador Edge TPU ao teu sistema, permitindo inferência de ML de alto desempenho e baixo consumo para modelos TensorFlow Lite. É uma ótima opção para implementações embarcadas e móveis onde um CPU sozinho não consegue acompanhar:
- Inferência mais rápida — o Edge TPU acelera modelos quantizados muito além do que o CPU do Raspberry Pi alcança por conta própria.
- Baixo consumo de energia — oferece alto rendimento por watt, ideal para implementações movidas a bateria ou energia solar.
- Plug-and-play — o USB Accelerator se conecta via USB 3.0, portanto, nenhuma integração de hardware adicional é necessária.
O guia oficial da Coral está desatualizado: as compilações originais do tempo de execução da Coral não funcionam mais com as versões atuais do tempo de execução do TensorFlow Lite, e o projeto não recebeu atualizações entre 2021 e 2025. Este guia usa um tempo de execução do Edge TPU ativamente mantido e o mais recente tflite-runtime para que o acelerador funcione em uma instalação atual do Raspberry Pi OS.
Pré-requisitos#
- Raspberry Pi 4B (2 GB ou mais recomendado) ou Raspberry Pi 5 (Recomendado)
- Raspberry Pi OS Bullseye/Bookworm (64 bits) com desktop (Recomendado)
- Coral USB Accelerator
- Uma plataforma não ARM (Google Colab, uma máquina Linux x86_64 ou o contêiner Docker da Ultralytics) para exportar o modelo, já que o compilador do Edge TPU não está disponível em ARM
Este guia pressupõe que você já tenha uma instalação funcional do Raspberry Pi OS com o ultralytics e suas dependências instaladas. Caso contrário, siga o guia de início rápido primeiro.
Com os pré-requisitos prontos, o fluxo de trabalho tem três etapas: instalar o tempo de execução do Edge TPU no Pi, exportar seu modelo em uma máquina não ARM e executar a inferência de volta no Pi.
Instalar o Runtime do Edge TPU#
O runtime é disponibilizado em várias compilações, por isso escolhe a que corresponde ao teu sistema operativo. A compilação de alta frequência executa o Edge TPU a uma velocidade de clock superior para melhor desempenho, mas pode causar thermal throttling — usa algum tipo de refrigeração se a escolheres.
| Raspberry Pi OS | Modo de alta frequência | Versão para download |
|---|---|---|
| Bullseye 32 bits | Não | libedgetpu1-std_ ... .bullseye_armhf.deb |
| Bullseye 64 bits | Não | libedgetpu1-std_ ... .bullseye_arm64.deb |
| Bullseye 32 bits | Sim | libedgetpu1-max_ ... .bullseye_armhf.deb |
| Bullseye 64 bits | Sim | libedgetpu1-max_ ... .bullseye_arm64.deb |
| Bookworm 32 bits | Não | libedgetpu1-std_ ... .bookworm_armhf.deb |
| Bookworm 64 bits | Não | libedgetpu1-std_ ... .bookworm_arm64.deb |
| Bookworm 32 bits | Sim | libedgetpu1-max_ ... .bookworm_armhf.deb |
| Bookworm 64 bits | Sim | libedgetpu1-max_ ... .bookworm_arm64.deb |
Baixe a versão mais recente daqui e, em seguida, instale o pacote .deb:
sudo dpkg -i path/to/package.debApós instalar o tempo de execução, conecte seu Coral Edge TPU a uma porta USB 3.0 no Raspberry Pi para que a nova regra udev possa entrar em vigor.
Remove primeiro qualquer runtime existente
Se já tiveres o runtime do Coral Edge TPU instalado, desinstala-o antes de instalar uma nova compilação.
# If you installed the standard version
sudo apt remove libedgetpu1-std
# If you installed the high-frequency version
sudo apt remove libedgetpu1-maxExportar o teu modelo para o formato Edge TPU#
Para usar o Edge TPU, converta seu modelo para um formato compatível. Execute a exportação em uma plataforma não ARM — Google Colab, uma máquina Linux x86_64, o contêiner Docker oficial da Ultralytics ou a Ultralytics Platform — já que o compilador do Edge TPU não está disponível em ARM. Consulte o modo Export para ver os argumentos disponíveis.
from ultralytics import YOLO
# Load a model
model = YOLO("path/to/model.pt") # Load an official model or custom model
# Export the model
model.export(format="edgetpu")O modelo exportado é salvo na pasta <model_name>_saved_model/ como <model_name>_full_integer_quant_edgetpu.tflite.
O nome do arquivo deve terminar com _edgetpu.tflite. Se você renomeá-lo para qualquer outra coisa, a Ultralytics o carregará como um modelo TensorFlow Lite simples em vez de detectar o Edge TPU, e o acelerador não será usado.
Executar inferência no Edge TPU#
Antes de executar o modelo, instala as bibliotecas corretas no Raspberry Pi. Se o TensorFlow já estiver instalado, desinstala-o primeiro:
pip uninstall tensorflow tensorflow-aarch64Em seguida, instale ou atualize o tflite-runtime:
pip install -U tflite-runtimeAgora podes executar a inferência:
from ultralytics import YOLO
# Load a model
model = YOLO("path/to/<model_name>_full_integer_quant_edgetpu.tflite") # Load an official model or custom model
# Run Prediction
model.predict("path/to/source.png")Encontre detalhes completos do modo de previsão na página Predict.
Se você tiver vários Edge TPUs, poderá selecionar um específico com o argumento device.
from ultralytics import YOLO
# Load a model
model = YOLO("path/to/<model_name>_full_integer_quant_edgetpu.tflite") # Load an official model or custom model
# Run Prediction
model.predict("path/to/source.png") # Inference defaults to the first TPU
model.predict("path/to/source.png", device="tpu:0") # Select the first TPU
model.predict("path/to/source.png", device="tpu:1") # Select the second TPUBenchmarks#
Os números abaixo foram medidos com Raspberry Pi OS Bookworm de 64 bits e um USB Coral Edge TPU. Eles mostram apenas o tempo de inferência (pré/pós-processamento excluído) e servem como referência relativa para a aceleração que o Edge TPU proporciona entre modelos e modos do Pi.
Estes benchmarks foram registados com modelos YOLOv8. Os tempos de inferência absolutos variam de acordo com a versão do modelo e o tamanho da imagem, mas os ganhos de velocidade relativos entre os modelos Pi e os modos de clock permanecem consistentes.
| Tamanho da Imagem | Modelo | Tempo de Inferência Padrão (ms) | Tempo de Inferência de Alta Frequência (ms) |
|---|---|---|---|
| 320 | YOLOv8n | 32.2 | 26.7 |
| 320 | YOLOv8s | 47.1 | 39.8 |
| 512 | YOLOv8n | 73.5 | 60.7 |
| 512 | YOLOv8s | 149.6 | 125.3 |
Em média:
- O Raspberry Pi 5 é 22% mais rápido com o modo padrão do que o Raspberry Pi 4B.
- O Raspberry Pi 5 é 30,2% mais rápido com o modo de alta frequência do que o Raspberry Pi 4B.
- O modo de alta frequência é 28,4% mais rápido do que o modo padrão.
Conclusão#
Um Coral Edge TPU transforma um Raspberry Pi em um dispositivo de inferência capaz e de baixo consumo de energia para o Ultralytics YOLO26. Exporte seu modelo em uma máquina não ARM, mantenha o sufixo _edgetpu.tflite e execute-o com tflite-runtime no Pi para obter inferência acelerada no edge. Para mais opções de implantação, consulte o guia do Raspberry Pi.
FAQ#
O Coral Edge TPU é um dispositivo compacto que adiciona um coprocessador Edge TPU ao teu sistema. Este coprocessador permite uma inferência de ML de alto desempenho e baixo consumo, particularmente otimizada para modelos TensorFlow Lite. Num Raspberry Pi, acelera a inferência muito além do que o CPU alcança sozinho, o que impulsiona significativamente o desempenho para modelos Ultralytics YOLO26.
Baixe o pacote
.debapropriado para a sua versão do Raspberry Pi OS a partir deste link e, em seguida, instale-o:sudo dpkg -i path/to/package.debCertifique-se de desinstalar quaisquer versões anteriores do tempo de execução do Coral Edge TPU seguindo as etapas na seção Instalar o tempo de execução do Edge TPU.
Sim. Execute a exportação no Google Colab, em uma máquina Linux x86_64 ou no contêiner Docker da Ultralytics; você também pode usar a Ultralytics Platform. Veja como exportar com Python e CLI:
Exportar o modelofrom ultralytics import YOLO # Load a model model = YOLO("path/to/model.pt") # Load an official model or custom model # Export the model model.export(format="edgetpu")Para obter mais informações, consulte a documentação do modo Export.
Se você tiver o TensorFlow instalado e precisar mudar para o
tflite-runtime, desinstale o TensorFlow primeiro:pip uninstall tensorflow tensorflow-aarch64Em seguida, instale ou atualize o
tflite-runtime:pip install -U tflite-runtimePara instruções detalhadas, consulte a seção Executar inferência no Edge TPU.
Após exportar seu modelo YOLO26 para um formato compatível com Edge TPU, execute a inferência com os seguintes trechos. O arquivo do modelo deve manter o sufixo
_edgetpu.tflitepara que a Ultralytics o carregue no Edge TPU:Executar o modelofrom ultralytics import YOLO # Load a model model = YOLO("path/to/<model_name>_full_integer_quant_edgetpu.tflite") # Load an official model or custom model # Run Prediction model.predict("path/to/source.png")Detalhes abrangentes sobre o modo de previsão estão na página Predict.