Dependencias do Sistema

Todas as ferramentas que o Nomics Hub precisa, com detalhes de instalacao, verificacao e notas importantes.

Essa pagina e a referencia completa de tudo que precisa estar instalado na maquina. Cada dependencia tem seu papel especifico — algumas sao obrigatorias para o sistema funcionar, outras so sao necessarias para funcionalidades especificas como transcricao ou automacao de browser.

Homebrew

Sistema4.0+

Gerenciador de pacotes para macOS. Permite instalar, atualizar e remover ferramentas com um comando.

Verificar

$brew --version

Instalar

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

Nota: Necessario para instalar Node, Python, Git e ffmpeg. Sem ele, voce precisa instalar cada ferramenta manualmente.

Node.js

Sistema18+

Runtime JavaScript. Roda o Claude Code, os MCPs baseados em NPX e qualquer ferramenta JS do workspace.

Verificar

$node --version

Instalar

$brew install node

Nota: Versao 18 e o minimo. Recomendado usar a versao LTS mais recente.

Python 3

Sistema3.9+

Linguagem de programacao usada pelos MCPs nativos (Meta Ads, Instagram, Drive Export) e por ferramentas de transcricao.

Verificar

$python3 --version

Instalar

$brew install python3

Nota: O macOS ja vem com Python, mas pode ser uma versao antiga. Instale via Homebrew para garantir.

Git

Sistema2.0+

Sistema de controle de versao. Usado para clonar o repositorio, fazer commits e sincronizar com o GitHub.

Verificar

$git --version

Instalar

$brew install git

Nota: Se voce usa macOS, o Xcode Command Line Tools ja instala o Git. Verifique com git --version.

Claude Code

PrincipalUltima

CLI oficial da Anthropic. E a interface principal do Nomics Hub — roda no terminal e acessa todo o workspace.

Verificar

$claude --version

Instalar

$npm install -g @anthropic-ai/claude-code

Nota: Atualize frequentemente: npm update -g @anthropic-ai/claude-code. Novas versoes trazem melhorias importantes.

ffmpeg

Midia7+

Framework de processamento de audio e video. Extrai audio de videos para o pipeline de transcricao.

Verificar

$ffmpeg -version

Instalar

$brew install ffmpeg

Nota: Instalacao pesada (~500MB). So e necessario se voce vai usar transcricao de video/audio.

yt-dlp

MidiaQualquer

Ferramenta para baixar videos de qualquer plataforma (YouTube, Instagram, Facebook, etc). Alimenta o pipeline de transcricao.

Verificar

$yt-dlp --version

Instalar

$pip3 install yt-dlp

Nota: O binario fica em ~/Library/Python/3.9/bin/. Adicione ao PATH se nao for encontrado.

faster-whisper

Midia1.0+

Engine de transcricao por IA que roda localmente. Converte audio em texto usando modelos Whisper otimizados.

Verificar

$python3 -c "import faster_whisper; print(faster_whisper.__version__)"

Instalar

$pip3 install faster-whisper

Nota: O primeiro uso baixa o modelo de IA (~1.5GB). A transcricao roda 100% local, sem enviar dados para nenhum servidor.

Playwright

AutomacaoQualquer

Framework de automacao de browser. Usado para screenshots de LPs, navegacao no Clarity e testes de paginas.

Verificar

$npx playwright --version

Instalar

$npx playwright install chromium

Nota: Instala apenas o Chromium (~200MB). Firefox e WebKit nao sao necessarios para o Nomics Hub.

Pillow

Utilidade10+

Biblioteca Python para processamento de imagens. Usada para redimensionar, converter e otimizar imagens.

Verificar

$python3 -c "from PIL import Image; print(Image.__version__)"

Instalar

$pip3 install Pillow

Nota: Geralmente ja vem instalado com outras dependencias Python.

Python Venvs (ambientes virtuais)

Os MCPs nativos (Meta Ads, Instagram, Drive Export) rodam em Python com ambientes virtuais isolados. Cada venv tem suas proprias dependencias e nao interfere nos outros. Esse isolamento evita conflitos de versao entre pacotes.

Criar todos os venvs

# Meta Ads MCP
cd ~/Desktop/Nomics/tools/meta-ads-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
deactivate

# Instagram MCP
cd ~/Desktop/Nomics/tools/instagram-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
deactivate

# Drive Export
cd ~/Desktop/Nomics/tools/drive-export
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
deactivate

O que e um venv?

Um venv (virtual environment) e uma pasta isolada com seu proprio Python e pacotes. Quando voce ativa um venv com source venv/bin/activate, o pip install so afeta esse ambiente. Ao desativar com deactivate, volta ao Python global.