Case / 02 2026
Coleoptera Identifier COLEOPTERA_IDENTIFIER
PESQUISA EM IA APLICADA / PROTOTYPE
Resumo
Curiosidade por besouros virou um protótipo full-stack: uma TUI em Go envia imagens para uma API FastAPI, o BioCLIP procura parentes na árvore da vida e o sistema responde somente com o nível taxonômico que seus limiares permitem sustentar.
Os animais invertebrados representam cerca de 97% de todas as espécies conhecidas no planeta. Estima-se cerca de 10 quintilhões de insetos vivos na Terra hoje, com aproximadamente 1 milhão de espécies catalogadas pela ciência. Dentre essa quantidade absurda de organismos, a ordem dos Coleoptera (besouros) ocupa 40% de todas as espécies de insetos catalogadas, sendo o maior grupo de insetos do planeta.
Não é de se admirar a apropriação das características dos besouros na cultura e em todas as mídias artísticas. No filme Alien (1979), os viajantes da tripulação do cargueiro interestelar são surpreendidos por um monstro que muito se parece com um besouro. No jogo de videogame Hollow Knight (2017), acompanhamos a "jornada do herói" de um personagem que é um inseto -- e não um qualquer: um besouro. Na literatura, há a clássica novela modernista A Metamorfose (1915), de Franz Kafka, na qual o protagonista Gregor Samsa acorda transformado em um inseto após uma noite de sonhos agitados. Apesar de Kafka não ter descrito a espécie, sua aparência é frequentemente associada à de um besouro.
Independentemente de as associações aos Coleoptera estarem ligadas ao pavor ou ao maravilhamento, todas as perspectivas apontam para uma estranha curiosidade em relação a esses cascudos. Imagino que nem o maior entomofóbico negaria sua curiosidade por esses seres de aparências tão sublimes. É alimentado por essa curiosidade que surge o Coleoptera Identifier: um experimento de visão computacional para transformar uma fotografia em uma hipótese sobre a posição do inseto na taxonomia.
Referências
- CAMARGO, Amabilio J. A. de. Ordem Coleoptera - Embrapa Cerrados - Portal Embrapa. Disponível em: https://www.embrapa.br/web/cerrados/colecao-entomologica/coleoptera [↑] (abre em nova aba). Acesso em: 4 set. 2026.
- AMORIM, Dalton de Souza. O lugar dos insetos na biodiversidade. Disponível em: https://jornal.usp.br/artigos/o-lugar-dos-insetos-na-biodiversidade/ [↑] (abre em nova aba). Acesso em: 5 set. 2026.

Coleoptera Identifier · Capa Editorial
Fotografia de besouro tratada em verde e preto.

TUI · Análise em andamento
O cliente em Go envia a imagem enquanto o modelo permanece isolado no servidor.

TUI · Hipótese taxonômica
Prévia pixelada, nível taxonômico sugerido e alternativas reunidos sem esconder as limitações do modelo.

TUI · Fora de Coleoptera
Quando a sugestão sai do universo dos besouros, a interface interrompe a árvore taxonômica e sinaliza o limite.

Coleoptera Identifier · Capa Externa
Capa utilizada no Github e em outros meios externos.
Uma única foto não determina a variedade inteira de um animal. Espécies visualmente parecidas podem exigir escala, localização, microscopia ou a avaliação de um especialista, enquanto modelos de catálogo fechado sempre encontram algum candidato -- mesmo quando a imagem está fora do escopo esperado. O desafio era construir uma ferramenta útil para além da curiosidade e que jamais vendesse o score do modelo como certeza científica, além de manter a inferência pesada no servidor e tratar imagens recebidas como entradas não confiáveis.
O software foi dividido em um cliente de terminal em Go e uma API em Python com FastAPI. A TUI seleciona a imagem, produz uma prévia pixelada e oferece uma interface bilíngue (pt-BR e en-US); o servidor valida o formato, tamanho, dimensões e origem antes de carregar o BioCLIP sob demanda. As previsões são agregadas por ordem, família e gênero, e limiares heurísticos escolhem o nível mais específico que pode ser sugerido. O GBIF [↑] (abre em nova aba) normaliza os nomes. URLs remotas ficam desabilitadas por padrão e, quando habilitadas, passam por allowlist, limite de redirects e bloqueio de redes privadas.
O protótipo ganhou um fluxo completo, da escolha da fotografia à apresentação de sua hipótese taxonômica, com direito a árvore de classificação, candidatos alternativos, score e aviso científico explícito. A mesma API atende à interface interativa e fornece uma saída JSON para automações, enquanto o carregamento tardio do modelo, contratos tipados e testes determinísticos mantêm a base preparada para evolução. Ainda faltam um classificador binário dedicado para barrar imagens fora de Coleoptera e uma avaliação com dataset representativo.
Ficha técnica / 06
Atuação
Pesquisa aplicada, arquitetura e desenvolvimento full-stack
Interfaces
- [Go]
- [Bubble Tea]
Sistemas e APIs
- [Python]
- [FastAPI]
- [GBIF API]
Dados e automação
- [Python]
- [PyTorch]
- [BioCLIP]
- [GBIF API]
Segurança
- [FastAPI]