Zarv Agent

O Zarv Agent (zarv-agent) é um agente on-premise que roda na rede do cliente. Ele ingere streams de câmeras (RTSP/ONVIF), executa a visão computacional localmente (veículo, pessoa, placa, face) e envia à Zarv apenas os eventos relevantes e a mídia associada — o vídeo bruto nunca sai do perímetro.

É distribuído como um pacote autocontido: ffmpeg, o runtime de inferência e os modelos já vêm embutidos. Não há dependências externas para resolver além da glibc — você instala e o serviço sobe sozinho.

Como funciona

Câmeras (RTSP/ONVIF)  →  Zarv Agent (inferência local)  →  Zarv (eventos + mídia)
                              ↑
                    Zarv (registro, configuração, OTA)

• Plano de dados: o agente decodifica cada stream, roda os modelos ONNX e emite eventos. Só o que é relevante sobe para a nuvem.
• Plano de controle: o registro, a configuração por dispositivo, os heartbeats e as atualizações são orquestrados pela Zarv. Depois de registrado, o agente se mantém atualizado por OTA — zero manutenção do seu lado.

Sistemas operacionais suportados

Plataforma	Método	Arquiteturas
Debian 11+ / Ubuntu 20.04+	APT (nativo)	amd64, arm64
RHEL 9+ / Fedora / openSUSE	RPM (nativo)	x86_64, aarch64
Outros Linux / macOS	Docker	amd64, arm64
Windows	Docker (via PowerShell)	amd64

Os pacotes nativos (APT/RPM) são a forma recomendada: instalam o serviço zarv-agent com auto-start no boot via systemd e se atualizam pelo próprio repositório, sob controle da Zarv.

Requisitos

• Acesso de saída HTTPS (porta 443) para collector.zarv.com — registro, configuração, heartbeat, atualizações (OTA) e upload de eventos/telemetria. (Em staging, collector.zarv.dev via EDGE_AGENT_DEBUG=true.)
• Acesso de rede às câmeras (RTSP/ONVIF) dentro do perímetro.
• Porta 8088 local para a interface de gerenciamento (usada apenas no primeiro registro; não precisa estar exposta na rede).
• Privilégio de root/sudo para a instalação nativa (registra o serviço systemd zarv-agent).

Próximos passos

• Instalação — instale em Debian/Ubuntu, RHEL/Fedora, Docker ou Windows.
• Registro — registre o dispositivo com a chave de enrollment da Zarv.
• Atualizações automáticas — como o OTA funciona e como configurar uma janela de manutenção (ex.: só às 03:00).
• Configuração — variáveis de ambiente locais.
• Solução de problemas — diagnóstico de serviço, rede, câmeras e armazenamento.