Instalar

O Perfica é um arquivo de download por sistema, publicado na página de lançamentos.

Sistema	Arquivo	Arquiteturas
Windows	Perfica-Setup-<version>.exe	x64
macOS	.dmg	Intel (x64) e Apple silicon (arm64)
Linux	.AppImage	x64 e arm64

Windows

1. Execute o arquivo de instalação.
2. Escolha onde instalá-lo. O instalador é por usuário, portanto não precisa de administrador.
3. Abra o Perfica a partir do menu Iniciar.

As compilações do Perfica ainda não têm assinatura de código, então o Windows SmartScreen exibe um aviso na primeira vez que você executa o instalador. Escolha Mais informações e depois Executar assim mesmo.

As atualizações chegam dentro do aplicativo. Por padrão, o Perfica baixa um novo lançamento em segundo plano e o instala quando você pressiona Reiniciar para atualizar na bandeja ou Reiniciar e atualizar em Configurações › Geral. Se houver loops em execução, ele pergunta primeiro: Atualizar quando ocioso ou Parar execuções e atualizar agora.

macOS

Abra o .dmg e arraste o Perfica para Aplicativos.

O macOS o bloqueia na primeira vez porque não está assinado: abra Ajustes do Sistema › Privacidade e Segurança e escolha Abrir Assim Mesmo.

Como a compilação para macOS não está assinada, ela não consegue se atualizar sozinha. Quando uma nova versão for lançada, baixe-a na página de lançamentos e instale-a por cima da antiga.

Linux

Torne o AppImage executável e execute-o:

chmod +x Perfica-*.AppImage
./Perfica-*.AppImage

O AppImage se atualiza no mesmo lugar quando um novo lançamento é publicado.

Fechar e sair

Fechar a janela não encerra o Perfica. Ele continua rodando na bandeja, para que os loops continuem. Para sair, use Sair do Perfica no menu da bandeja. Se ainda houver algo em execução, o Perfica pergunta antes de parar, com Parar execuções e sair.

O que o Perfica precisa

• Git for Windows no Windows, para que os agentes executem correntes de comandos como npm install && npm test. Sem ele, apenas comandos únicos são executados, e o Perfica informa onde obter o Git.
• Um modelo. Uma chave para um provedor hospedado ou um modelo local via Ollama ou LM Studio. Veja Adicionar uma chave de provedor.

Próximo: Primeira execução.