Blog

23 de outubro de 2026

Sistema de câmera com IA: detecte mesas ocupadas e tempo de espera com Claude Code

Passo a passo para criar, numa VPS e com Claude Code, um sistema que detecta pessoas em vídeo, mapeia zonas de mesa e mostra há quanto tempo cada lugar está ocupado, com o caminho até câmeras ao vivo e os cuidados com a LGPD.

por Thalena Lima

8 min de leitura26 leituras
Vídeo complementarAbrir no YouTube(abre em nova guia)

Resposta rápida

Um sistema de câmera com IA detecta pessoas em vídeo com um modelo de visão computacional (como o RF-DETR), mede quanto tempo cada uma fica dentro de uma zona definida, como uma mesa, e exibe o resultado num painel. No tutorial, o projeto open source Supervision, a API da Roboflow e o Claude Code numa VPS entregam isso sem placa de vídeo.

Um sistema de câmera com IA usa visão computacional para detectar pessoas em vídeo, medir quanto tempo cada uma permanece dentro de uma zona (como uma mesa) e mostrar o resultado num painel. No projeto demonstrado, Supervision, RF-DETR via API da Roboflow e Claude Code numa VPS sustentam o sistema, sem placa de vídeo.

Por que negócios com fila e espera precisam enxergar mesas e tempo de ocupação

Em um restaurante, o dono raramente sabe quais mesas estão ocupadas, há quanto tempo cada uma está assim e qual vai liberar primeiro. O cliente na porta não tem essa informação, a mesa espera pelo garçom e o horário de pico real fica no palpite. A lógica se repete em barbearias (cadeira ocupada), academias, clínicas (sala de espera), salões e filas de caixa.

No tutorial de Thalena Lima, o sistema nasceu de um projeto gratuito e open source do GitHub. Ela abriu o Claude Code numa VPS e pediu que a IA ajustasse a solução para achar pessoas, achar mesas e informar quem ocupa cada uma e por quanto tempo. As ferramentas foram instaladas e o código foi escrito pela própria IA. Os testes usaram um vídeo de restaurante gerado por IA, não uma operação real: a demonstração prova o método, não a precisão num salão lotado.

As quatro peças do sistema e o que cada uma faz

PeçaPapel no sistemaOnde rodaCusto no projeto demonstrado
Supervision (Roboflow)Biblioteca open source (licença MIT) com um exemplo de tempo em zona, que mede quanto tempo uma pessoa fica dentro de uma áreaNa VPSGratuito
RF-DETRModelo de visão, já treinado, que localiza pessoas e objetos na imagemAPI da Roboflow, nos servidores delesPlano gratuito para demonstrações; produção exige acompanhar o consumo
Claude CodeClona o projeto, instala as ferramentas, escreve o código e publicaNa VPSExige plano pago do Claude
VPS HostingerMantém o sistema no ar 24 horas, sem depender do seu notebookData centerPaga; KVM 2 para clientes, KVM 1 para testes e protótipos simples

Uma API funciona como um balcão de atendimento entre dois sistemas: o seu envia uma foto à Roboflow e recebe de volta uma lista do que foi encontrado (pessoas, cadeiras, mesas). Como a detecção roda nos servidores da Roboflow, a VPS não precisa de placa de vídeo.

[!tip] VPS Hostinger com cupom THALENA
A descrição do vídeo indica a VPS Hostinger com o cupom THALENA, anunciado como 10% OFF nos planos anuais de VPS e válido para contas novas. Confirme valor e elegibilidade no checkout.

Passo a passo: da VPS em branco ao painel no ar

  1. Contrate a VPS. Escolha o plano KVM 2, aplique o cupom THALENA, selecione a localização com melhor latência (o Brasil pode não estar disponível) e marque o Claude Code na lista de aplicativos. O cupom vale para os planos anuais de 12 ou 24 meses. Depois do pagamento, abra a VPS em Gerenciar e clique em Web Console para acessar o terminal.
  2. Entre no Claude Code. Digite claude, escolha o tema, abra o link de login, autorize no navegador e cole o código no terminal. O tutorial exige um plano pago do Claude.
  3. Peça para a IA preparar o ambiente. Thalena trocou para o Sonnet com esforço médio (comando /model), porque o Opus não é necessário para organizar a VPS. A IA parou antes do firewall, como solicitado, e propôs bloquear tudo que tenta entrar e liberar só três portas: a de administração, a 80 e a 443 (web). Leia a proposta, entenda e só então autorize.
  4. Preencha as chaves você mesmo no arquivo .env. Saia do Claude Code com Ctrl+C duas vezes, abra o .env no editor nano e cole a chave da API da Roboflow (nas configurações da conta, na área de API) e a senha de demonstração do painel. Salve com Ctrl+X, Y e Enter. Não cole a chave no chat do Claude Code nem a mostre a ninguém: ela funciona como uma senha.
  5. Aponte um subdomínio para a VPS. No gerenciador de DNS do domínio, crie um registro do tipo A com o nome do subdomínio (por exemplo, restaurante) e o IP da VPS, que aparece no menu VPS. A propagação pode levar alguns minutos. O DNS é a agenda de contatos da internet: traduz o endereço em texto no número do servidor.
  6. Mande a IA clonar o repositório e estruturar o projeto. Peça que ela estude o projeto, explique em linguagem simples como vai configurar o que você quer e use o seu endereço. É aqui que entram as suas especificações, como outro tipo de negócio ou funções extras. A IA também configurou um servidor web na frente do sistema, que pede usuário e senha e ativa o HTTPS sozinho, sem comprar certificado. O teste inicial foi uma página "em construção" atrás do login (usuário demo e a senha definida no .env).
  7. Teste o motor com um vídeo curto, antes do painel. Troque para o Opus e peça que a IA baixe um vídeo e extraia os frames de apenas 2 segundos dele. Um vídeo é uma sequência de fotos, e a IA analisa foto por foto. O resultado mostrou pessoas, cadeiras e até uma planta, cada uma com um número de confiança: quanto maior, mais segura a identificação. Nenhum treinamento foi necessário, porque o modelo já vem treinado com um conjunto famoso de imagens. Confira se a IA identificou corretamente e se há bugs visuais.
  8. Mapeie as zonas das mesas e acompanhe a ocupação ao longo do vídeo. A IA mapeou as zonas e passou a mostrar quantas mesas estavam ocupadas: quem ficou sentado manteve a mesa ocupada, e a mesa foi liberada quando a pessoa saiu. Num cliente real, esse mapeamento precisa ser refeito conforme a disposição das mesas daquele dia.
  9. Só depois monte o painel. A ordem importa: se o painel viesse primeiro e algo falhasse, não haveria como saber se o problema era a interface ou a detecção. Thalena pediu o painel numa ferramenta que transforma um programa Python em página web (upload, botões, vídeo analisado e tempo de ocupação) e manteve o login com senha. Mostrar a solução de forma visual ajuda o cliente a enxergar a dor que ela resolve. A tela de login ainda estava simples e pode ser personalizada.
  10. Empacote com Docker. Até aqui o sistema dependia do terminal aberto. Pedir à IA que empacote o projeto com Docker o mantém no ar mesmo com o computador fechado. Thalena testou pelo celular e a tela de login apareceu.

No painel da Roboflow, a demonstração aparece com 10 créditos consumidos, e Thalena considera o plano gratuito adequado para demonstrações. Em produção será preciso acompanhar o consumo e pagar pela API. Peça também ao cliente um vídeo real gravado pela câmera dele, para testar o desempenho e montar uma demonstração.

Da demonstração à câmera ao vivo: câmera, mini PC, VPS e WhatsApp

Os testes usaram vídeo gravado no lugar da câmera. Na solução real o caminho é o mesmo e só muda a entrada. O vídeo apresentou a arquitetura abaixo como proposta de implantação; ela não foi construída na demonstração.

EtapaFunçãoO que trafega
Câmera (no teto ou na lateral)Filma o ambiente o tempo todo e envia a imagem pela rede do estabelecimento; não decide nem avisa ninguémVídeo, só dentro do local
Mini PC no estabelecimentoAssiste à imagem sem parar e, quando algo importa, escreve um aviso curtoO vídeo fica aqui; sai só o aviso
VPSRecebe o aviso e o encaminha, como um carteiroTexto
WhatsAppEntrega a mensagem ao gerente ou ao donoMensagem

O que vira serviço é o alerta, não o painel: uma mensagem no WhatsApp do gerente quando uma mesa passa de 5 minutos sem visita do garçom (a ideia dada no tutorial), um aviso de mesa que vagou e um relatório de horário de pico para montar a escala da equipe. A receita vem da implementação, da personalização e do suporte. O blog tem um guia complementar sobre agente de IA no WhatsApp com Claude Code numa VPS.

O tutorial não detalha o custo da API da Roboflow com câmeras ao vivo. Verifique o consumo de créditos antes de precificar o serviço para um cliente.

LGPD: o cuidado antes de vender câmera com IA

Imagem de pessoa identificável é dado pessoal. A Lei 13.709/2018 (LGPD) define dado pessoal como a informação relacionada a pessoa natural identificada ou identificável (art. 5º, I). Filmar clientes e funcionários, portanto, exige cuidado.

O desenho apresentado limita o que o sistema guarda: na versão de produção, ele não reconhece rostos e não precisa armazenar imagem de ninguém. Para ele importam a mesa, o estado (ocupada ou livre) e o tempo. Confirme isso na configuração real antes de entregar. O estabelecimento também precisa de um aviso visível explicando para que serve a câmera. Isto não é parecer jurídico: ao fechar um cliente, envolva alguém que entenda de LGPD.

Recursos, Descontos e Ecossistema Lena AI

Assista ao tutorial prático no YouTube

Vídeo complementar: Sistema de Câmera Grátis com Agente de IA (Instalação Completa)

Para continuar

Perguntas frequentes

Resumo e fontes

Pontos-chave5
  • Um sistema de câmera com IA para mesas combina três funções: detectar pessoas no vídeo, associá-las a zonas desenhadas sobre as mesas e medir há quanto tempo cada zona está ocupada.
  • Detectar pessoas com o modelo RF-DETR por API dispensa placa de vídeo no servidor, porque a inferência roda na infraestrutura da Roboflow e o sistema recebe apenas a lista do que foi encontrado.
  • Num projeto de visão computacional, valide a detecção com um vídeo curto antes de construir o painel; assim um erro pode ser atribuído à IA ou à interface.
  • Numa câmera de estabelecimento, guardar só o estado da mesa, o horário e o tempo, sem reconhecer rostos nem armazenar imagens, limita o dado pessoal tratado; o aviso visível sobre a câmera continua necessário.
  • Um alerta no WhatsApp do gerente, como mesa sem visita do garçom por mais de 5 minutos, é o que transforma a detecção em serviço vendável; o painel sozinho é a demonstração.
Respostas curtas4
Como saber há quanto tempo uma mesa de restaurante está ocupada com IA?
A IA analisa o vídeo da câmera quadro a quadro, detecta as pessoas e verifica se estão dentro da zona desenhada sobre cada mesa. O exemplo de tempo em zona do projeto Supervision mede quanto tempo a pessoa permanece na área, e o painel exibe o resultado por mesa.
É preciso placa de vídeo para rodar visão computacional num servidor?
No projeto demonstrado, não. O modelo RF-DETR roda nos servidores da Roboflow e o sistema o consulta pela API: envia a imagem e recebe a lista de pessoas e objetos. A VPS cuida do restante do sistema, o que dispensa GPU local.
Que negócios podem usar um sistema de câmera com IA para fila e espera?
Restaurantes, barbearias, academias, clínicas, salões e filas de caixa em supermercados e padarias. A lógica é a mesma: definir a zona (mesa, cadeira, fila ou sala de espera), detectar pessoas e medir ocupação e tempo.
Câmera com IA em estabelecimento exige cuidados com a LGPD?
Sim. A imagem de uma pessoa identificável é dado pessoal. O desenho apresentado evita reconhecer rostos e guardar imagens, usando apenas mesa, estado e tempo, e o estabelecimento deve exibir aviso visível sobre a câmera. Isto não é parecer jurídico.
Fontes6

Próximas leituras