Instalacao Passo a Passo

Clone o repositorio, configure as APIs e verifique que tudo funciona. Em 6 passos voce tera o Nomics Hub rodando.

Siga cada passo na ordem. Cada etapa depende da anterior, entao nao pule nenhuma. Se algo der errado, consulte a pagina de Troubleshooting.

Pre-requisito

Certifique-se de que todas as dependencias estao instaladas antes de continuar. Veja Pre-requisitos.

Clonar o repositorio

Baixe o workspace completo do GitHub para sua maquina. Isso cria a pasta ~/Desktop/Nomics com todos os arquivos.

Clonar

$git clone https://github.com/nomicsadmin/nomics-intelligence-hub.git ~/Desktop/Nomics

Nota: Voce precisa de acesso ao repositorio privado. Peca convite para o admin no GitHub.

Entrar na pasta do workspace

Todos os comandos a partir daqui devem ser executados dentro da pasta do Nomics.

Navegar

$cd ~/Desktop/Nomics

Configurar variaveis de ambiente

O arquivo .env contem todas as chaves de API. Copie o template e edite com suas chaves reais.

Copiar template

$cp .env.example .env

Abrir para editar

$code .env

Nota: Preencha cada variavel com a chave real. Veja a pagina APIs e .env para saber onde obter cada uma.

Instalar MCPs Python

Os MCPs de Meta Ads, Instagram e Drive Export rodam em Python com ambientes virtuais isolados (venvs). Cada um precisa de seu proprio venv.

Criar venvs e instalar dependencias

# 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

# Voltar para a raiz
cd ~/Desktop/Nomics

Nota: Cada venv isola as dependencias para evitar conflitos. Nao pule essa etapa.

Configurar MCPs no Claude Code

O arquivo settings.json diz ao Claude Code quais MCPs estao disponiveis e como conectar com cada um. Ele ja vem pre-configurado no repositorio.

Verificar configuracao

$cat .claude/settings.json

Nota: Se voce criou os venvs nos caminhos padrao (passo 4), os MCPs ja vao funcionar. Caso contrario, ajuste os paths no settings.json.

Verificar tudo

O smoke test valida que todos os 8 squads estao configurados corretamente. O resultado esperado e 8/8 squads operacionais.

Smoke test

$bash squads/smoke-test.sh

Nota: Se algum squad falhar, verifique o arquivo config.yaml dentro de squads/[nome-do-squad]/.

Checklist final

Repositorio clonado em ~/Desktop/Nomics

Arquivo .env criado e preenchido com chaves reais

Venv do Meta Ads MCP instalado e funcionando

Venv do Instagram MCP instalado e funcionando

Venv do Drive Export instalado e funcionando

settings.json configurado com os MCPs

Smoke test retorna 8/8 squads operacionais

Claude Code instalado (npm install -g @anthropic-ai/claude-code)

Tudo pronto?

Se todos os itens do checklist estao marcados, siga para Configuracao do Claude Code para entender como o Claude Code funciona dentro do VS Code.