Pre-requisitos

O que seu computador precisa ter instalado antes de comecar. Cada ferramenta tem um papel especifico no sistema.

O Nomics Hub depende de algumas ferramentas para funcionar. A boa noticia: a maioria se instala com um unico comando. Abaixo esta a lista completa com o que cada uma faz, como verificar se ja tem e como instalar.

Dica rapida

Se voce ja tem o Homebrew instalado, pode pular direto para o bloco "Instalar tudo de uma vez" no final da pagina.

Homebrew

4.0+

Gerenciador de pacotes para Mac. Permite instalar tudo o resto com um comando.

Verificar

$brew --version

Instalar

$/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Node.js

18+

Motor JavaScript que roda o Claude Code. Sem ele, nada funciona.

Verificar

$node --version

Instalar

$brew install node

Python 3

3.9+

Linguagem dos MCPs (Meta Ads, Instagram, Drive Export). Essencial para as conexoes externas.

Verificar

$python3 --version

Instalar

$brew install python3

Git

2.0+

Controle de versao do workspace. Permite clonar o repositorio e manter tudo sincronizado.

Verificar

$git --version

Instalar

$brew install git

ffmpeg

Processa videos para transcricao. Usado pelo faster-whisper para extrair audio de qualquer formato.

Verificar

$ffmpeg -version

Instalar

$brew install ffmpeg

yt-dlp

Qualquer

Baixa videos de qualquer plataforma (YouTube, Instagram, etc). Alimenta o pipeline de transcricao.

Verificar

$yt-dlp --version

Instalar

$pip3 install yt-dlp

faster-whisper

1.0+

Transcreve audio em texto usando IA local. Primeiro uso baixa o modelo (~1.5GB).

Verificar

$python3 -c "import faster_whisper"

Instalar

$pip3 install faster-whisper

Playwright

Qualquer

Automacao de navegador. Usado para screenshots, analise de LPs e fallback do Clarity.

Verificar

$npx playwright --version

Instalar

$npx playwright install chromium

Instalar tudo de uma vez

Copie e cole esse bloco inteiro no terminal. Ele instala todas as dependencias na ordem correta.

Instalacao completa

# Base (obrigatorio)
brew install node python3 git ffmpeg

# Midia e transcricao
pip3 install yt-dlp faster-whisper

# Automacao
npx playwright install chromium

# Claude Code (a ferramenta principal)
npm install -g @anthropic-ai/claude-code

Algo deu erro?

Se algum comando retornar erro durante a instalacao, va para a secao Troubleshooting onde listamos os problemas mais comuns e suas solucoes.

Proximo passo

Com tudo instalado, siga para Instalacao Passo a Passo para clonar o repositorio e configurar o workspace.