App desktop

O app desktop abre o painel do Neuro Harness numa janela nativa (Electron 44) e cuida de instalar, atualizar, subir e parar o Harness. Ele usa o mesmo núcleo da CLI. Use esta página para instalar o app à mão ou para abri-lo pela primeira vez.

O instalador de uma linha já instala o app no macOS com Apple Silicon e no Windows. Só baixe à mão se você usou --sem-app ou quer reinstalar.

Sistemas e arquivos

Sistema	Arquivo
macOS com Apple Silicon (M1 em diante)	Neuro-Harness-<versão>-arm64.dmg
Windows 10/11, 64 bits	Neuro-Harness-Setup-<versão>.exe

Não há app para Mac com Intel nem para Linux. Nesses sistemas, use o painel no navegador com neuro-harness open.

Baixar

Página de download

Os arquivos também estão na página de Releases do repositório. Hoje, o download leva à Release no GitHub e só abre para contas com acesso ao repositório.

Instalar

macOS

1. Abra o .dmg.
2. Arraste o Neuro Harness para a pasta Aplicativos.
3. Abra o app. Na primeira vez, siga Abrir um app sem assinatura.

Windows

1. Rode o Neuro-Harness-Setup-<versão>.exe.
2. Siga o instalador. Você pode escolher a pasta de instalação.
3. Abra o Neuro Harness pelo menu Iniciar. Se o SmartScreen aparecer, siga Abrir um app sem assinatura.

Linux

Não há app desktop para Linux. Instale com o instalador de uma linha e use o painel no navegador.

Abrir um app sem assinatura

Os instaladores ainda não têm assinatura de código. Por isso, o sistema avisa na primeira abertura.

macOS

O Gatekeeper bloqueia a primeira abertura. Faça uma das duas coisas:

• Clique com o botão direito no app, escolha Abrir e depois Abrir de novo.

• Ou tire a quarentena pelo Terminal:

  Terminal

  xattr -dr com.apple.quarantine "/Applications/Neuro Harness.app"

O instalador de uma linha já faz isso por você.

Windows

Na tela do SmartScreen, clique em Mais informações e depois em Executar assim mesmo.

Linux

Não se aplica.

Para tirar esses avisos, os apps precisam de assinatura: certificado Apple Developer ID com notarização no macOS e certificado de assinatura de código no Windows.

O que o app faz ao abrir

1. Confere as dependências. Se faltar alguma, o botão Instalar o que falta abre o Terminal (ou o PowerShell) com o instalador. Siga a janela: ela pode pedir a senha do computador e o login no GitHub. O app continua sozinho quando o instalador termina.
2. Instala ou atualiza a distribuição. O app roda o setup e mostra o andamento na tela de abertura. Na primeira vez, baixa o DeepSeek Harness (cerca de 550 MB) e o motor neuro-mv-edit. Nas outras, só confere e atualiza o que mudou.
3. Sobe o Harness. Se a CLI já subiu o Harness, o app reaproveita.
4. Abre o painel numa janela nativa. O app entra no painel sozinho, sem o aviso de token do navegador.

Ao sair, o app para o Harness, se foi ele que o subiu.

Links dentro do app

• Endereços locais (127.0.0.1 e localhost), como o Remotion Studio, abrem dentro do app.
• Links externos abrem no navegador padrão.

PATH no macOS

Apps abertos pelo Finder recebem um PATH mínimo. Por isso, o app lê o PATH do seu shell de login (Homebrew, nvm etc.) para achar o Node.js, o git, o Python e o FFmpeg.

Variáveis de ambiente

O app herda do shell de login só o PATH. Se uma sessão precisa de outra variável do seu terminal, como o token da Meta do neuro-ads-manager, suba o Harness pelo terminal com neuro-harness start antes de abrir o app. O app reaproveita o Harness que já está rodando.

Montar o app a partir do código

Na pasta apps/desktop de um clone do neuro-harness:

Terminal

npm ci
npm start            # roda sem empacotar, com o lib/ e o plugins/ do repositório
npm run pack         # app sem instalador em dist/
npm run dist:mac     # dist/Neuro-Harness-<versão>-arm64.dmg (num Mac)
npm run dist:win     # dist/Neuro-Harness-Setup-<versão>.exe (num Windows)

A cada tag v*, o workflow App desktop do CI monta o .dmg e o .exe e os anexa à Release.