Ultralytics YOLO27:
Get Started

Como executar Ultralytics YOLO26 em um Raspberry Pi com um Coral Edge TPU#

Raspberry Pi with Edge TPU accelerator

Um Raspberry Pi é uma plataforma acessível e eficiente em termos de energia para executar visão computacional na borda, mas a inferência no dispositivo é lenta, mesmo com formatos otimizados como ONNX ou OpenVINO. Emparelhar o Pi com um coprocessador Coral Edge TPU transfere a inferência para hardware dedicado e aumenta drasticamente a velocidade. Este guia mostra como instalar o runtime, exportar um modelo Ultralytics YOLO26 para o formato Edge TPU e executar inferência acelerada.



Assista: Como executar inferência no Raspberry Pi usando 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 de energia para modelos TensorFlow Lite. É uma ótima opção para implementações embarcadas e móveis, nas quais apenas uma CPU não consegue acompanhar:

  • Inferência mais rápida — o Edge TPU acelera modelos quantizados muito além do que a CPU do Raspberry Pi consegue alcançar sozinha.
  • Baixo consumo de energia — oferece alto desempenho por watt, ideal para implementações alimentadas por bateria ou energia solar.
  • Pronto para usar — o Acelerador USB conecta-se via USB 3.0, sem exigir integração de hardware adicional.
Runtime atualizado para a versão atual do TensorFlow Lite

O guia oficial do Coral está desatualizado: as compilações do runtime original do Coral já não funcionam com as versões atuais do runtime TensorFlow Lite, e o projeto não recebeu atualizações entre 2021 e 2025. Este guia usa um runtime Edge TPU mantido ativamente e a versão mais recente de tflite-runtime para que o acelerador funcione numa instalação atual do Raspberry Pi OS.

Pré-requisitos#

Este guia pressupõe que já tens uma instalação funcional do Raspberry Pi OS com ultralytics e as dependências instaladas. Se não for esse o caso, segue primeiro o guia de início rápido.

Com os pré-requisitos prontos, o fluxo de trabalho tem três etapas: instalar o runtime Edge TPU no Pi, exportar o modelo numa máquina Linux x86_64 e executar a inferência novamente no Pi.

Instalar o runtime Edge TPU#

O runtime está disponível em várias compilações; 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 oferecer melhor desempenho, mas pode causar limitação térmica — usa algum tipo de refrigeração se a escolheres.

Raspberry Pi OSModo de alta frequênciaVersão para transferência
Bullseye 32 bitsNãolibedgetpu1-std_ ... .bullseye_armhf.deb
Bullseye 64 bitsNãolibedgetpu1-std_ ... .bullseye_arm64.deb
Bullseye 32 bitsSimlibedgetpu1-max_ ... .bullseye_armhf.deb
Bullseye 64 bitsSimlibedgetpu1-max_ ... .bullseye_arm64.deb
Bookworm 32 bitsNãolibedgetpu1-std_ ... .bookworm_armhf.deb
Bookworm 64 bitsNãolibedgetpu1-std_ ... .bookworm_arm64.deb
Bookworm 32 bitsSimlibedgetpu1-max_ ... .bookworm_armhf.deb
Bookworm 64 bitsSimlibedgetpu1-max_ ... .bookworm_arm64.deb

Transfere a versão mais recente aqui e, em seguida, instala o pacote .deb:

sudo dpkg -i path/to/package.deb

Depois de instalar o runtime, liga o Coral Edge TPU a uma porta USB 3.0 do Raspberry Pi para que a nova regra udev entre em vigor.

Remove primeiro qualquer runtime existente

Se já tiveres o runtime 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-max

Exportar o modelo para o formato Edge TPU#

Para usar o Edge TPU, converte o modelo para um formato compatível. Executa a exportação no Linux x86_64 — Google Colab, uma máquina Linux x86_64, o contêiner Docker oficial da Ultralytics num host x86_64 ou a Plataforma Ultralytics — já que o compilador Edge TPU só está disponível no Linux x86_64. Consulta o modo de exportação para ver os argumentos disponíveis.

Exportar o modelo
from ultralytics import YOLO

# Carregar um modelo
model = YOLO("path/to/model.pt")  # Carrega um modelo oficial ou um modelo personalizado

# Exporta o modelo
model.export(format="edgetpu")

O modelo exportado é guardado na pasta <model_name>_saved_model/ como <model_name>_full_integer_quant_edgetpu.tflite.

Mantém o sufixo `_edgetpu.tflite`

O nome do ficheiro tem de terminar com _edgetpu.tflite. Se lhe deres outro nome, a Ultralytics vai carregá-lo como um modelo LiteRT (.tflite) comum, em vez de detetar 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-aarch64

Em seguida, instala ou atualiza tflite-runtime:

pip install -U tflite-runtime

Agora podes executar a inferência:

A executar o modelo
from ultralytics import YOLO

# Carregar um modelo
model = YOLO("path/to/yolo26n_full_integer_quant_edgetpu.tflite")  # Carrega um modelo oficial ou um modelo personalizado

# Executa a predição
model.predict("path/to/source.png")

Encontra todos os detalhes sobre o modo de predição na página Predict.

Inferência com vários Edge TPUs

Se tiveres vários Edge TPUs, podes selecionar um específico com o argumento device.

from ultralytics import YOLO

# Carregar um modelo
model = YOLO("path/to/yolo26n_full_integer_quant_edgetpu.tflite")  # Carrega um modelo oficial ou um modelo personalizado

# Executa a predição
model.predict("path/to/source.png")  # A inferência usa o primeiro TPU por predefinição

model.predict("path/to/source.png", device="tpu:0")  # Seleciona o primeiro TPU

model.predict("path/to/source.png", device="tpu:1")  # Seleciona o segundo TPU

Benchmarks#

Os valores abaixo foram medidos com Raspberry Pi OS Bookworm de 64 bits e um Coral Edge TPU USB. Mostram apenas o tempo de inferência (excluindo o pré-processamento e o pós-processamento) e servem como referência relativa para a aceleração proporcionada pelo Edge TPU nos diferentes modelos de Pi e modos.

Sobre estes valores

Estes benchmarks foram registados com modelos YOLOv8. Os tempos absolutos de inferência variam conforme a versão do modelo e o tamanho da imagem, mas os ganhos relativos de velocidade entre modelos de Pi e modos de clock mantêm-se.

Tamanho da imagemModeloTempo de inferência padrão (ms)Tempo de inferência em alta frequência (ms)
320YOLOv8n32.226.7
320YOLOv8s47.139.8
512YOLOv8n73.560.7
512YOLOv8s149.6125.3

Em média:

  • O Raspberry Pi 5 é 22% mais rápido do que o Raspberry Pi 4B no modo padrão.
  • O Raspberry Pi 5 é 30,2% mais rápido do que o Raspberry Pi 4B no modo de alta frequência.
  • 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 num dispositivo de inferência capaz e de baixo consumo de energia para Ultralytics YOLO26. Exporta o modelo numa máquina Linux x86_64, mantém o sufixo _edgetpu.tflite e executa-o com tflite-runtime no Pi para obter inferência acelerada na borda. Para mais opções de implementação, consulta o guia Raspberry Pi.

Perguntas frequentes#

  • O Coral Edge TPU é um dispositivo compacto que adiciona um coprocessador Edge TPU ao teu sistema. Esse coprocessador permite inferência de ML de alto desempenho e baixo consumo de energia, especialmente otimizada para modelos TensorFlow Lite. Num Raspberry Pi, acelera a inferência muito além do que a CPU consegue alcançar sozinha, aumentando significativamente o desempenho dos modelos Ultralytics YOLO26.

  • Transfere o pacote .deb adequado à tua versão do Raspberry Pi OS a partir deste link e, em seguida, instala-o:

    sudo dpkg -i path/to/package.deb

    Certifica-te de que desinstalas todas as versões anteriores do runtime Coral Edge TPU seguindo as etapas da seção Instalar o runtime Edge TPU.

  • Sim. Executa a exportação no Google Colab, numa máquina Linux x86_64 ou no contêiner Docker da Ultralytics; também podes usar a Plataforma Ultralytics. Vê como exportar com Python e CLI:

    Exportar o modelo
    from ultralytics import YOLO
    
    # Carregar um modelo
    model = YOLO("path/to/model.pt")  # Carrega um modelo oficial ou um modelo personalizado
    
    # Exporta o modelo
    model.export(format="edgetpu")

    Para mais informações, consulta a documentação do modo de exportação.

  • Se tiveres o TensorFlow instalado e precisares de mudar para tflite-runtime, desinstala primeiro o TensorFlow:

    pip uninstall tensorflow tensorflow-aarch64

    Em seguida, instala ou atualiza tflite-runtime:

    pip install -U tflite-runtime

    Para instruções detalhadas, consulta a seção Executar inferência no Edge TPU.

  • Depois de exportares o modelo YOLO26 para um formato compatível com o Edge TPU, executa a inferência com os trechos de código a seguir. O ficheiro do modelo tem de manter o sufixo _edgetpu.tflite para que a Ultralytics o carregue no Edge TPU:

    A executar o modelo
    from ultralytics import YOLO
    
    # Carregar um modelo
    model = YOLO("path/to/yolo26n_full_integer_quant_edgetpu.tflite")  # Carrega um modelo oficial ou um modelo personalizado
    
    # Executa a predição
    model.predict("path/to/source.png")

    Encontra todos os detalhes sobre o modo de predição na página Predict.

Comentários