Mac
no Terminal/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
curl -LsSf https://astral.sh/uv/install.sh | sh
brew install node git
Guia · Mac e Windows
Ouve, pensa e fala em português
Um assistente de IA que roda 100% no seu computador, com voz em português e ativação por palma. A base é o OpenJarvis, projeto aberto de dois laboratórios de Stanford. Aqui tem o prompt pro Claude Code instalar tudo por você, o passo a passo pra Mac e Windows e a saída pros problemas mais comuns.
faster whispersua voz vira textogemma4:e4ba IA do Google, no seu PCKokororesponde em portuguêstudo roda no seu computadorsem conta · sem mensalidade
Antes de tudo
Tá no celular agora? Manda este guia pra você mesmo e abre no computador.
3 peças · todas grátis
Pra funcionar, você não cria nenhuma conta. Cada peça faz uma parte do trabalho, tudo dentro da sua máquina.
Baixa e roda o modelo de IA no seu computador. Tem app pra Mac e pra Windows.
ollama.com · grátis · sem contaOuve o microfone e transforma a fala em texto. O modelo é público e baixa sem login.
github.com/SYSTRAN/faster-whisper · grátisTransforma a resposta em voz, offline, com a voz pf_dora em português do Brasil.
Opcional · só se você quiser
A melhor voz do mercado. Pede conta e chave de API. elevenlabs.io
Voz ou modelo na nuvem. O Jarvis já suporta, é só colocar a chave de API.
Mac ou Windows, o fluxo é o mesmo. No Mac você instala com o Homebrew. No Windows, com o winget, que já vem no Windows 10 e 11. O cérebro é o Gemma 4 do Google, na versão gemma4:e4b, com download de até 9,5 GB.
Passo 0 · uma vez só
Três ferramentas de base: o uv, que cuida do Python, o Node e o Git. Rode só o bloco do seu sistema. Se já tiver alguma, pula a linha.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
curl -LsSf https://astral.sh/uv/install.sh | sh
brew install node git
Aperte a tecla Windows, digite cmd e dê Enter. O winget já vem no Windows 10 e 11. Se faltar, instale o App Installer pela Microsoft Store. Rode um comando por vez.
winget install -e --id astral-sh.uv
winget install -e --id OpenJS.NodeJS.LTS
winget install -e --id Git.Git
Depois de instalar o uv, abra uma janela nova. Confira com uv --version, node --version e git --version. No Windows, use o cmd. O PowerShell bloqueia o npm.
O projeto não roda no Python 3.14. O uv escolhe a versão certa sozinho. Só não force a mais nova.
Use se alguma etapa travar no seu computador. Documentação oficial
curl -fsSL https://open-jarvis.github.io/OpenJarvis/install.sh | bash
powershell -ExecutionPolicy ByPass -c "irm https://open-jarvis.github.io/OpenJarvis/install.ps1 | iex"
Três rotas, o mesmo destino. A rápida é colar o prompt no Claude Code. A manual é rodar cada comando na mão. O plano B fica pra quando alguma etapa travar.
A rota rápida · cole no Claude Code
Abra o Claude Code numa pasta vazia, cole o prompt inteiro e deixe ele trabalhar. Ele detecta seu sistema, instala, configura e ainda monta a ativação por palma. Você só aprova.
Instale o OpenJarvis (assistente de IA local, projeto aberto de laboratórios de Stanford) do zero neste computador e configure voz em português do Brasil. Detecte o meu sistema operacional (Mac ou Windows) e use os comandos certos para ele. Antes de cada etapa, diga em uma frase o que vai fazer. Passos: 1. Clone https://github.com/open-jarvis/OpenJarvis para uma pasta chamada "jarvis" e entre nela. 2. Garanta uv, Git, Node e Ollama instalados. Se algum faltar, instale: Mac: Homebrew, depois brew install node git ollama, e brew services start ollama. O uv pelo instalador oficial da Astral. Windows: winget install -e --id astral-sh.uv, Git.Git, OpenJS.NodeJS.LTS e Ollama.Ollama. O Node precisa ser 22.22 ou mais novo. Depois de instalar, abra um terminal novo para o PATH atualizar. 3. Dentro de jarvis/: uv sync --extra desktop --extra voice (instala o faster-whisper, que ouve, e o Kokoro, que fala). O projeto exige Python de 3.10 a 3.13; deixe o uv escolher e não force o 3.14. Se faltar dependência de compilação, siga a instalação manual da documentação oficial em https://open-jarvis.github.io/OpenJarvis/getting-started/installation/ 4. Baixe o modelo local: ollama pull gemma4:e4b (até 9,5 GB). Se a máquina tiver pouca memória ou o modelo ficar lento demais, troque por gemma4:e2b (até 7,5 GB) e me avise. 5. Configure: uv run jarvis _bootstrap --write-config --engine ollama --model gemma4:e4b Depois: uv run jarvis config set security.profile personal 6. Voz em português: Mac: brew install portaudio espeak-ng Windows: nada a instalar, o eSpeak NG já vem embutido no passo 3 (pacote espeakng-loader). Só se o Kokoro reclamar do espeak: winget install -e --id eSpeak-NG.eSpeak-NG e grave PHONEMIZER_ESPEAK_LIBRARY com setx apontando para "C:\Program Files\eSpeak NG\libespeak-ng.dll". Nos dois: uv run jarvis config set speech.voice_id pf_dora E para ele me ouvir em português: uv run jarvis config set speech.language pt 7. Interface web (opcional): dentro de frontend/, npm install e npm run build. Volte para jarvis/ e rode uv run jarvis start (porta 8000). 8. Valide com uv run jarvis doctor. Teste o texto com uv run jarvis ask "Em uma frase, quem é você?" e a voz com uv run jarvis chat --voice. Corrija o que o doctor apontar antes de seguir. 9. O OpenJarvis já conversa por voz, mas não tem ativação por palma. Crie na pasta jarvis um comando jarvis-show que: escuta o microfone, detecta duas palmas seguidas, toca voz/assets/jingle.mp3 se existir, abre a interface web e inicia uv run jarvis chat --voice. Leia as variáveis JARVIS_CLAP_THRESH (sensibilidade da palma) e JARVIS_MIC (qual microfone). Me explique como rodar e como ajustar a sensibilidade. 10. No fim, me mostre um resumo: o que foi instalado, onde ficou, quanto de disco ocupou e os três comandos que eu vou usar no dia a dia. Regras: rode tudo local. NÃO me peça para digitar senhas ou chaves em campos do navegador. Se alguma etapa precisar de chave de API, me diga o nome da variável e eu mesmo coloco no arquivo .env. Se um comando falhar, leia o erro inteiro, diga a causa em português simples e tente a correção antes de me pedir ajuda.
Por que o fim do prompt importa: ele proíbe o Claude de pedir senha no navegador. Chave de API fica no arquivo .env, digitada por você. Vale pra qualquer instalação com IA.
A rota manual · Terminal
Rode na ordem, um bloco por vez. Tudo dentro da pasta jarvis depois do passo 1.
git clone https://github.com/open-jarvis/OpenJarvis jarvis cd jarvis
uv sync --extra desktop --extra voice
O faster whisper e o Kokoro vêm juntos nesse comando.
brew install ollama brew services start ollama ollama pull gemma4:e4b
O brew services start liga o Ollama agora e a cada login. Computador mais fraco? Troque por gemma4:e2b (até 7,5 GB).
uv run jarvis _bootstrap --write-config --engine ollama --model gemma4:e4b uv run jarvis config set security.profile personal
brew install portaudio espeak-ng uv run jarvis config set speech.voice_id pf_dora uv run jarvis config set speech.language pt
A voz padrão vem em inglês. Essas linhas trocam pra pf_dora e fazem ele te ouvir em português.
cd frontend npm install npm run build cd .. uv run jarvis start
Abre em 127.0.0.1:8000. Pra desligar: uv run jarvis stop
uv run jarvis doctor uv run jarvis ask "Em uma frase, quem é você?"
O doctor diz exatamente o que falta.
A interface só aparece depois do build. Sem o passo 6, a porta 8000 abre vazia. Se o doctor acusar erro de compilação, use o plano B.
A rota manual · Prompt de Comando
Use o Prompt de Comando (cmd), não o PowerShell. Rode na ordem, um bloco por vez.
git clone https://github.com/open-jarvis/OpenJarvis jarvis cd jarvis
uv sync --extra desktop --extra voice
No Windows, esse passo já traz o que a voz precisa pra funcionar.
winget install -e --id Ollama.Ollama
ollama pull gemma4:e4b
O app sobe sozinho e fica na bandeja, perto do relógio. Se o terminal não achar o ollama, abra uma janela nova. Computador mais fraco? Troque por gemma4:e2b (até 7,5 GB).
uv run jarvis _bootstrap --write-config --engine ollama --model gemma4:e4b uv run jarvis config set security.profile personal
uv run jarvis config set speech.voice_id pf_dora uv run jarvis config set speech.language pt
No Windows não precisa instalar nada a mais pra falar e ouvir em português.
cd frontend npm install npm run build cd .. uv run jarvis start
Abre em 127.0.0.1:8000. Pra desligar: uv run jarvis stop
uv run jarvis doctor uv run jarvis ask "Em uma frase, quem é você?"
O doctor diz exatamente o que falta.
Pede Windows 10 versão 1809 ou mais novo e Node 22.22 ou mais novo. Se o doctor acusar erro de compilação, use o plano B.
Do grátis ao premium
Comece pela grátis. Ela já fala português direitinho.
Fala offline. A troca pra pf_dora, em português, está no passo 5. Nenhuma conta, custo zero.
O Jarvis já suporta. Você coloca a chave de API e troca com um comando, logo abaixo.
O Jarvis não tem suporte nativo a ela. Voz gravada: exporte em mp3 e use como jingle.mp3. Tempo real: coloque a ELEVENLABS_API_KEY no .env e peça pro Claude Code criar a integração.
Vem no modo auto, com o modelo base. Dá pra trocar por OpenAI ou Deepgram na chave speech.backend. O local já resolve.
Primeiro defina a chave no terminal. Mac: export OPENAI_API_KEY=sk-... Windows: set OPENAI_API_KEY=sk-... Pra Cartesia, a variável é CARTESIA_API_KEY.
uv run jarvis config set speech.tts_backend openai_tts
uv run jarvis config set speech.tts_backend cartesia
uv run jarvis config set speech.tts_backend kokoro
A ordem que funciona: uma semana na voz grátis, usando de verdade. Só depois decida se a premium vale uma assinatura.
Do terminal à cena de filme
4 jeitos que já vêm no Jarvis, mais o modo show.
uv run jarvis
No primeiro uso, pode abrir a configuração inicial.
uv run jarvis ask "Resuma o meu dia em três prioridades"
Responde e sai.
uv run jarvis start
Abre em http://127.0.0.1:8000. Pra desligar: uv run jarvis stop
uv run jarvis chat --voice
Ouve, pensa e fala. Já vem de fábrica.
Toca o áudio de abertura e abre a conversa por voz.
jarvis-show
O áudio de abertura fica em voz/assets/jingle.mp3. Pode ser um export da ElevenLabs. Pra ajustar:
JARVIS_CLAP_THRESHsensibilidade da palmaJARVIS_MICqual microfone usarNo Mac use export VAR=valor. No Windows, set VAR=valor.
Transparência: a palma e o jingle não vêm no OpenJarvis oficial. É um comando que o Claude Code escreve pra você no passo 9 do prompt. Se instalou na mão, cole só o bloco abaixo no Claude Code.
O OpenJarvis já conversa por voz, mas não tem ativação por palma. Crie na pasta jarvis um comando jarvis-show que: escuta o microfone, detecta duas palmas seguidas, toca voz/assets/jingle.mp3 se existir, abre a interface web e inicia uv run jarvis chat --voice. Leia as variáveis JARVIS_CLAP_THRESH (sensibilidade da palma) e JARVIS_MIC (qual microfone). Me explique como rodar e como ajustar a sensibilidade.
ln -sf "$PWD/.venv/bin/jarvis" ~/.local/bin/jarvis
Windows: rode uv run jarvis dentro da pasta, ou adicione .venv\Scripts ao PATH.
O pulo do gato do modo show é o áudio de abertura. Um jingle bem feito transforma um assistente de terminal numa cena de filme.
Leia antes de desistir
Antes de tudo, rode uv run jarvis doctor. Ele diz exatamente o que falta. Abaixo, os 7 problemas mais comuns e a saída de cada um.
Coloque a variável antes do comando.
HOMEBREW_NO_REQUIRE_TAP_TRUST=1 brew install ollama
Instale o App Installer pela Microsoft Store, ou baixe cada programa no site oficial.
Dê permissão de microfone ao terminal. Mac: Ajustes › Privacidade e Segurança › Microfone. Windows: Configurações › Privacidade › Microfone.
Suba o servidor com o comando abaixo. No Mac, deixe ligado de vez com brew services start ollama. No Windows, o app fica na bandeja, perto do relógio.
ollama serve
Aponte os caminhos do Homebrew. Em Mac com chip Intel, troque /opt/homebrew por /usr/local.
export PHONEMIZER_ESPEAK_LIBRARY=/opt/homebrew/lib/libespeak-ng.dylib export ESPEAK_DATA_PATH=/opt/homebrew/share/espeak-ng-data
É raro, porque ele já vem embutido. Se acontecer, instale o eSpeak NG, rode a segunda linha e abra um terminal novo.
winget install -e --id eSpeak-NG.eSpeak-NG
setx PHONEMIZER_ESPEAK_LIBRARY "C:\Program Files\eSpeak NG\libespeak-ng.dll"
Ajuste o JARVIS_CLAP_THRESH do jarvis-show. Subir deixa menos sensível. Descer deixa mais.
Travou em algo fora da lista? Cole o erro inteiro no Claude Code e peça: “leia este erro, diga a causa e rode a correção”.
O que você recebeu
Próximo passo
Hoje, cole o prompt no Claude Code e deixe o modo grátis rodando, Ollama com Kokoro. Rode o doctor no fim. Voz premium só depois de uma semana de uso.