Agente local
Todos os testes rodam no agente instalado na rede do cliente, garantindo que a origem seja o IP dele.
Conexão com o agente
Por padrão a interface procura o agente em http://127.0.0.1:8765. Ajuste se ele estiver em outra porta ou em outra máquina da mesma rede.
Endereço em uso agora: http://127.0.0.1:8765
Como executar na máquina do cliente
Baixe o pacote, extraia em qualquer pasta da máquina que está dentro da rede do cliente e execute um único arquivo.
Baixar agente 1.1.2 (.zip)
Passo 1 — Extrair o pacote
- Baixe o pacote 1.1.2 e extraia em uma pasta nova na máquina que está dentro da rede do cliente — não execute o arquivo diretamente de dentro do ZIP.
Passo 2 — Executar o único arquivo
- Windows: duplo clique em
INICIAR_AGENTE.bat. Linux/macOS:bash iniciar_agente.sh. - O próprio script verifica e instala o Python na versão correta, as dependências e o ffprobe — não é preciso instalar nada manualmente. A primeira execução precisa de internet e pode levar alguns minutos; as próximas abrem em segundos.
- O script também libera a porta: encerra agentes Pix Force antigos e, se a 8765 estiver ocupada por outro programa, sobe automaticamente na próxima porta livre (8766, 8767…).
- Se o firewall do Windows perguntar, libere a porta.
Passo 3 — Deixar a janela aberta e conectar
- Mantenha a janela do agente aberta durante os testes — fechá-la desliga o agente.
- Copie o endereço mostrado na janela (ex.:
http://127.0.0.1:8765) para o campo Endereço do agente acima e clique em Testar. Se a janela indicar outra porta, use exatamente esse endereço. - Abrir esse endereço direto no navegador mostra apenas a página de status do agente — a ferramenta é usada aqui nesta interface.
Sem o agente rodando na rede do cliente, nenhum teste pode ser executado a partir do IP dele — os resultados só são válidos com o agente conectado.
Solução de problemas
- “Deseja finalizar o arquivo em lotes (S/N)?” → responda N e Enter. Se já respondeu S, execute o
INICIAR_AGENTE.batnovamente. - “Python nao encontrado” após a instalação automática → feche a janela, abra o
INICIAR_AGENTE.batnovamente (o PATH só é reconhecido em uma nova janela). - “A porta 8765 esta ocupada por outro programa” → resolvido na 1.1.2: o script encerra agentes antigos e, se necessário, sobe em outra porta. Use o endereço exibido na janela.
- Erro de CORS ou 404 em
/api/status→ feche a janela antiga, baixe o agente 1.1.2 pelo botão acima, extraia em uma pasta nova e execute novamente. A janela deve mostrar “versao 1.1.2”. Aba anônima não encerra um agente antigo que continua rodando no Windows. - Agente em outra máquina da rede: use
http://IP-DA-MAQUINA:8765no campo acima. - Falha ao instalar dependências → verifique internet/proxy e rode o script novamente.
- A janela do agente precisa continuar aberta na outra máquina.
Versão portátil (.exe)
O pacote já inclui o build_exe.ps1. Em uma máquina Windows com Python, rode powershell -ExecutionPolicy Bypass -File build_exe.ps1 para gerar um executável portátil que dispensa Python e já serve a interface junto.