Resumo da Notícia
Contexto Geral
O conteúdo apresenta o MH1, uma CLI de operações de marketing com IA, descrevendo métodos de instalação, configuração inicial com chave de API da Anthropic, estrutura de pastas por cliente, fluxo de execução de “skills” e módulos, opções de configuração e credenciais de plataformas, componentes de workflow, orientações para desenvolvedores, mecanismos de avaliação de qualidade e controle de custos, além de procedimentos de troubleshooting.
Principais Pontos
- Instalação recomendada via one-liner: curl -fsSL https://raw.githubusercontent.com/NewGameJay/mh1/main/install.sh | bash (instala em ~/.mh1 e adiciona mh1 ao PATH).
- Alternativas de instalação: pip install mh1-copilot e execução de mh1; ou git clone do repositório para ~/.mh1 seguido de ./install.sh.
- Primeira execução solicita ANTHROPIC_API_KEY; opção de definir previamente no arquivo ~/.mh1/.env.
- Execução de skills: verificação de insumos e acessos, coleta de dados faltantes, confirmação do usuário, execução com progresso em tempo real e salvamento do output em clients/{nome}/reports/.
- Exemplo de módulo “lifecycle audit”: requer acesso ao HubSpot (contatos) e, opcionalmente, Snowflake para enriquecimento; permite definir limite de contatos.
- Onboarding de novo cliente com coleta de informações como nome da empresa, setor, site, função do usuário e CRM utilizado.
- Variáveis de ambiente: obrigatória ANTHROPIC_API_KEY; opcionais para integrações (HUBSPOT_API_KEY, SNOWFLAKE_ACCOUNT, SNOWFLAKE_USER, SNOWFLAKE_PASSWORD).
- Configuração por cliente em clients/{nome}/config/ (datasources, conexões e thresholds), incluindo thresholds como high_value_min e dormant_days.
- Estrutura do projeto inclui diretórios para clientes, módulos, skills (análise, geração, estratégia), agentes, orquestradores, workers, avaliadores, biblioteca central, workflow, configurações (model-routing.yaml, input_schemas.yaml, quotas.yaml) e prompts.
- Para desenvolvedores: skills ficam em .skills/{categoria}-skills/{skill}/ com SKILL.md (definição, schemas de input/output e exemplos).
- Execução de skills via componente skill_executor e uso de Claude; componentes de workflow incluem pathway.py, inputs.py, markers.py, module_manager.py, além de evaluator.py e budget.py.
- Portas de qualidade: saídas com pontuação ≥ 80% são entregues automaticamente; abaixo disso passam por refinamento ou revisão.
- Limites de custo por cliente configuráveis em config/quotas.yaml (ex.: limites diários e mensais).
- Troubleshooting: verificação de .env para ANTHROPIC_API_KEY; listagem de skills pelo comando principal; validação de inputs obrigatórios e checagem de credenciais em .env ou clients/{nome}/config/.
Informações Essenciais
O MH1 é uma CLI de marketing com IA que permite executar habilidades e módulos com configuração guiada, salvando resultados por cliente em relatórios markdown. A instalação pode ser feita por script, pip ou clonagem do repositório, com necessidade de configurar ANTHROPIC_API_KEY. O sistema organiza credenciais e thresholds por cliente, oferece componentes de workflow e avaliação de qualidade, permite criação e validação de novas skills por desenvolvedores e inclui controles de custos e orientações de troubleshooting para variáveis de ambiente, credenciais, inputs e listagem de funcionalidades.
Fonte: pypi.org