Como instalar o OpenJarvis no Windows e no Mac

OpenJarvis: instalação de IA local em computadores Windows e Mac

Por Bora Criar com IA · Publicado em 14/10/2026

O OpenJarvis reúne ferramentas para criar assistentes de inteligência artificial com execução local. Neste guia, você encontra os caminhos oficiais para Windows e Mac, os comandos de instalação e uma forma simples de conferir se o serviço iniciou.

O que é o OpenJarvis

O projeto é desenvolvido por grupos de pesquisa de Stanford e disponibilizado como código aberto sob licença Apache 2.0. A proposta é usar modelos no próprio computador, com opções de integração a serviços externos. Isso permite experimentar conversas e agentes, mas o desempenho depende do modelo escolhido e dos recursos da máquina. Usar um provedor em nuvem também pode envolver custos e envio de dados.

Escolha o caminho para o seu computador

Windows com WSL2: caminho recomendado pela documentação para a maioria dos usuários; os comandos de instalação rodam dentro do Ubuntu.
Windows nativo: opção avançada pelo PowerShell, sem exigir uma máquina Linux virtual.
Mac: instalação pelo Terminal, com suporte documentado a processadores Intel e Apple Silicon.

Os procedimentos seguem os guias oficiais consultados em 14 de outubro de 2026. Consulte os requisitos do projeto antes de repetir o tutorial em outra versão.

Windows com WSL2: o caminho recomendado

Abra o PowerShell como administrador e instale o ambiente Linux:

wsl --install

Conclua as instruções do Windows e reinicie se solicitado. Depois, abra o Ubuntu instalado e execute o comando abaixo no terminal do Ubuntu, não no PowerShell:

curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh | bash

Quando a etapa inicial terminar, comece uma conversa:

jarvis

Os componentes dessa instalação ficam no ambiente Linux do WSL. Downloads e compilações adicionais podem continuar em segundo plano. Não confunda o término do primeiro comando com a conclusão de todos os modelos.

Windows nativo: instalar pelo PowerShell

Antes de começar, confira Windows 10 versão 1809 ou posterior, ou Windows 11; Python entre 3.10 e 3.13; Git disponível no PATH; e aproximadamente 5 GB livres em LOCALAPPDATA. Modelos adicionais podem exigir mais espaço.

No PowerShell, execute:

irm https://open-jarvis.github.io/OpenJarvis/install.ps1 | iex

O instalador verifica os pré-requisitos, prepara o uv e as dependências e coloca o código na pasta local do usuário. Ele também oferece a configuração de uma tarefa de inicialização automática; escolha conforme a sua necessidade.

Para iniciar o backend:

cd "$env:LOCALAPPDATA\OpenJarvis\src"
uv run jarvis serve

Com o processo em execução, abra http://127.0.0.1:8000/health no navegador. Esse endereço verifica a saúde do serviço: não é a tela de conversa nem comprova que um modelo respondeu. Para encerrar o processo iniciado nesse terminal, use Ctrl+C.

Mac: instalar pelo Terminal

Abra o aplicativo Terminal. O guia contempla Macs Intel e Apple Silicon. Caso o sistema peça as ferramentas de linha de comando da Apple ao usar Git ou curl, conclua a instalação. Você também pode solicitá-las antes:

xcode-select --install

Em seguida, execute:

curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh | bash

Ao terminar a etapa inicial, abra a conversa com:

jarvis

No Apple Silicon, o projeto detecta o hardware e pode recomendar o motor MLX, mas o instalador usa Ollama inicialmente por compatibilidade. Comece com a configuração preparada pelo projeto antes de trocar o motor ou aumentar o modelo.

O que esperar da instalação

O instalador Bash prepara o ambiente Python, o uv, o Ollama e um modelo inicial. Outros componentes podem ser preparados em segundo plano. O tempo varia com a conexão, o espaço disponível e o computador; reserve tempo para os downloads em vez de contar com um prazo fixo.

Os comandos de instalação baixam e executam scripts do projeto. Confira o domínio oficial e leia o script se quiser revisar as alterações antes de executá-lo. Durante a instalação Bash, há uma escolha sobre compartilhar dados de uso; você pode recusar.

Como verificar e resolver os primeiros problemas

No Mac ou no Ubuntu do WSL, consulte o diagnóstico:

jarvis doctor

Se jarvis não for encontrado depois da instalação Bash, abra um novo terminal para carregar o PATH atualizado. No Windows nativo, mantenha o comando uv run dentro da pasta do projeto.

Para testar uma resposta simples, no ambiente em que o comando jarvis já funciona:

jarvis ask "Explique em português o que é uma IA local."

Uma API saudável e uma resposta de modelo são verificações diferentes. Se o serviço inicia, mas a conversa falha, confira o diagnóstico, a configuração e se o motor de inferência está ativo. As instruções documentais não substituem esse teste na sua máquina.

E a interface no navegador?

O projeto oferece jarvis gui para iniciar a interface gráfica a partir do código-fonte. Essa opção pede Node.js 22 ou posterior e componentes adicionais. Por isso, primeiro valide a instalação básica. O endereço /health do backend não substitui a interface gráfica.

Comece com uma pergunta curta e um modelo compatível com seu computador. Depois de confirmar a resposta, explore os guias de agentes, memória e integrações do projeto.