Pular para o conteúdo
neuro harnessDocs

Instalação

Esta página cobre a instalação completa: o que precisa estar na máquina, o que o instalador faz, as opções dele e como atualizar ou remover. Para o caminho mais curto, use o Início rápido.

Requisitos

Seção intitulada “Requisitos”
Item Requisito
Sistema macOS, Linux com apt, dnf ou pacman, ou Windows 10/11 com winget e PowerShell 5.1+
Conta do GitHub Com acesso aos repositórios privados do Neuro Harness (acesso antecipado)
Disco Cerca de 550 MB para o DeepSeek Harness, mais o motor e os plugins
App desktop Opcional. macOS com Apple Silicon ou Windows x64

O instalador instala o que faltar entre estas ferramentas:

Ferramenta Versão macOS Linux Windows
Node.js 22+ Homebrew (node) NodeSource 22 (apt, dnf) ou nodejs (pacman) OpenJS.NodeJS.LTS
git qualquer Homebrew pacote git Git.Git
Python 3.10+ Homebrew (python) pacote python3 (python no pacman) Python.Python.3.12
FFmpeg 5+ Homebrew pacote ffmpeg (ffmpeg-free no dnf) Gyan.FFmpeg
GitHub CLI qualquer Homebrew (gh) repositório oficial do gh (apt), gh (dnf), github-cli (pacman) GitHub.cli

Para conferir o que já está instalado, sem instalar nada, rode neuro-harness deps depois da primeira instalação.

Instalar pelo terminal

Seção intitulada “Instalar pelo terminal”
Terminal
curl -fsSL https://harness.neuros.my/install.sh | bash

Os scripts não contêm segredos. Eles fazem o login no GitHub e baixam o resto com a sua conta.

O que o instalador faz

Seção intitulada “O que o instalador faz”

  1. Confere as dependências e instala o que faltar.

    • macOS: usa o Homebrew e instala o Homebrew se faltar. O macOS pede a sua senha.
    • Linux: usa apt, dnf ou pacman, com sudo. Outro gerenciador de pacotes interrompe a instalação.
    • Windows: usa o winget.

  2. Faz o login no GitHub pelo navegador (gh auth login --web) e deixa o git pronto para os repositórios privados. Em seguida, confere se a conta tem acesso ao repositório monrars1995/neuro-harness.

  3. Baixa o Neuro Harness da última Release (ou da versão de --versao) para ~/.neuro-harness/src.

  4. Põe o comando neuro-harness no PATH, em ~/.neuro-harness/bin.

    • macOS e Linux: acrescenta uma linha marcada com # neuro-harness ao ~/.zshrc e ao ~/.bashrc (se existirem) e ao ~/.profile.
    • Windows: acrescenta a pasta ao PATH do usuário.

    O comando vale nos terminais abertos depois da instalação.

  5. Roda o neuro-harness setup, que instala o DeepSeek Harness, o motor neuro-mv-edit, o perfil neuro e os plugins. A primeira vez baixa cerca de 550 MB.

  6. Importa as chaves de API do Hermes e do OpenCode, se encontrar ~/.hermes/.env ou ~/.local/share/opencode/auth.json. Veja Provedores e chaves.

  7. Instala o app desktop.

    • macOS com Apple Silicon: copia o app para /Applications (ou para ~/Applications, se a primeira não aceitar gravação) e tira a quarentena do Gatekeeper.
    • Windows: roda o instalador do app em modo silencioso. O app aparece no menu Iniciar como Neuro Harness.
    • Mac com Intel e Linux: não há app. Use o painel no navegador.

  8. Sobe o Neuro Harness e abre o painel, no app (macOS) ou no navegador.

Opções do instalador

Seção intitulada “Opções do instalador”
macOS e Linux Windows O que faz
--sem-app -SemApp Não instala o app desktop
--versao vX.Y.Z -Versao vX.Y.Z Instala uma versão específica. Padrão: a última Release
--sem-credenciais -SemCredenciais Não importa chaves de API do Hermes e do OpenCode
--sem-abrir -SemAbrir Não sobe nem abre o Neuro Harness no fim

No macOS e no Linux, passe as opções depois de bash -s --. No Windows, rode o script como bloco para aceitar parâmetros.

Terminal
curl -fsSL https://harness.neuros.my/install.sh | bash -s -- --sem-app --versao v0.2.1

O instalador também respeita NEURO_HARNESS_HOME, para instalar em outra pasta. Veja Variáveis de ambiente.

Conferir a instalação

Seção intitulada “Conferir a instalação”

Abra um terminal novo e rode:

Terminal
neuro-harness doctor

O doctor confere as ferramentas, o Harness, o motor, o perfil, os plugins, as chaves no cofre e o cache npm, e sai com o código 1 se algo falhar. Veja neuro-harness doctor.

Instalar a partir de um clone

Seção intitulada “Instalar a partir de um clone”

Use este caminho para desenvolver a distribuição. O git da máquina precisa de acesso aos repositórios privados, por gh auth login ou por uma chave SSH no GitHub.

Terminal
git clone https://github.com/monrars1995/neuro-harness.git
cd neuro-harness
node lib/cli.js setup --link
node lib/cli.js open
  • --link liga os plugins de marca e idioma direto do clone, em vez de copiá-los. Sem ele, o setup copia os plugins para ~/.neuro-harness/plugins.
  • npm link, na pasta do clone, deixa o comando neuro-harness no PATH. É opcional.

Atualizar

Seção intitulada “Atualizar”

Rode o mesmo comando de instalação de novo. O instalador baixa a última Release, roda o setup e só refaz o que mudou.

Para fixar uma versão, use --versao vX.Y.Z (ou -Versao vX.Y.Z no Windows).

Num clone, atualize o repositório com git pull e rode node lib/cli.js setup.

Desinstalar

Seção intitulada “Desinstalar”

  1. Pare o Harness:

    Terminal
    neuro-harness stop

  2. Apague a pasta da distribuição.

    Terminal
    rm -rf ~/.neuro-harness

  3. Tire o comando do PATH.

    • macOS e Linux: apague a linha que termina em # neuro-harness no ~/.zshrc, no ~/.bashrc e no ~/.profile.
    • Windows: tire %USERPROFILE%\.neuro-harness\bin do PATH do usuário.

  4. Remova o app, se ele foi instalado.

    • macOS: apague Neuro Harness.app de /Applications ou de ~/Applications.
    • Windows: desinstale o Neuro Harness como qualquer programa, nas configurações de aplicativos do Windows.

A biblioteca do neuro-mv-edit (~/.neuro-mv-edit) e a pasta de trabalho (~/Neuro) não são tocadas. Veja Pastas e arquivos.