Developers

Aparência

Vai integrar o Zarv Agent (on-premise) com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar o Zarv Agent (on-premise). Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/edge-agent/
- Instalação: https://developers.zarv.com/edge-agent/installation
- Registro: https://developers.zarv.com/edge-agent/enrollment
- Configuração: https://developers.zarv.com/edge-agent/configuration
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

O agente é um software instalado em máquina do cliente, não uma API que você chama: siga os passos de instalação, registro e configuração na ordem documentada, e use os arquivos e comandos exatamente como aparecem nas páginas.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: instalar, registrar e configurar o agente no meu ambiente]

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 ​

PlataformaMétodoArquiteturas
Debian 11+ / Ubuntu 20.04+APT (nativo)amd64, arm64
RHEL 9+ / Fedora / openSUSERPM (nativo)x86_64, aarch64
Outros Linux / macOSDockeramd64, arm64
WindowsDocker (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.
  • 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 ​