Agora vamos colocar a ferramenta de pé na sua máquina. Este módulo é prático e passo a passo: o que instalar antes, como pegar as duas chaves de API gratuitas, dois jeitos de instalar (automático e manual), onde colar as chaves e como confirmar que tudo funcionou — sem gastar nada.
Diagrama ilustrativo — a instalação é uma escada de poucos passos: baixar, criar o ambiente, instalar, configurar as chaves e está pronto.
Antes de qualquer comando, junte três coisas. Tê-las prontas antes de começar evita o erro mais comum de iniciante: travar no meio da instalação porque faltou algo básico.
A linguagem que roda a ferramenta. Baixe em python.org/downloads.
Uma da Perplexity e uma do Gemini. Você pega as duas nos próximos tópicos.
Prompt de Comando no Windows; Terminal no Mac/Linux. É onde você digita os comandos.
Na hora de instalar o Python no Windows, há uma caixinha fácil de ignorar — e ela causa metade dos problemas de quem começa:
No terminal, digite python --version (ou python3 --version). Se aparecer 3.9 ou maior, você está pronto. Se der erro, é sinal de que falta instalar — ou marcar o PATH.
A primeira das duas chaves vem da Perplexity — a IA que faz a pesquisa (Fase 1). Sem ela, nenhum documento é gerado. O processo leva uns 2 minutos.
Abra perplexity.ai/settings/api no navegador.
É grátis para começar. Faça login normalmente.
A chave aparece na tela. Ela começa com pplx-. Copie e guarde.
# formato (exemplo — a sua será diferente)
pplx-1a2b3c4d5e6f7g8h9i0j...Trate essa chave como uma senha: quem a tiver pode gastar o seu crédito.
Esta é a chave da Fase 1 (Pesquisa). Se ela faltar ou estiver errada, a ferramenta nem chega a escrever os documentos — para logo no começo, com erro de chave.
A segunda chave vem do Google Gemini — a IA que escreve os documentos (Fase 2). É grátis para começar e sai do Google AI Studio em poucos cliques.
Abra aistudio.google.com/apikey.
Serve a mesma conta Google que você já usa no dia a dia.
A chave começa com AIzaSy. Copie e guarde junto da outra.
As chaves vêm de sites diferentes (Perplexity e Google) e cada uma tem o seu próprio crédito. As duas têm plano gratuito para você testar antes de gastar de verdade.
Com o projeto baixado, há um atalho que faz quase tudo por você: um único comando. É o caminho recomendado para quem não quer mexer em cada etapa à mão.
# na pasta do projeto
python setup.pyEsse comando dispara um assistente que prepara o ambiente inteiro de uma vez.
Em alguns computadores o atalho pode tropeçar (versão de Python diferente, permissões, etc.). Não tem problema: o próximo tópico mostra a instalação manual, que faz exatamente as mesmas etapas, só que uma por uma.
Se preferir controlar cada passo — ou se o automático falhou — dá para instalar à mão. São quatro comandos simples. De quebra, você entende o que acontece por baixo dos panos.
# 1) Criar o ambiente virtual (a "caixa" isolada do projeto)
python3 -m venv venv
# 2) Ativar o ambiente
source venv/bin/activate # Mac / Linux
.\venv\Scripts\activate # Windows
# 3) Instalar as dependências
pip install -r requirements.txt
# 4) Criar o arquivo de chaves a partir do exemplo
cp .env.example .envRode na ordem. O passo 2 muda conforme o seu sistema — use só a linha que corresponde a ele.
Toda vez que abrir um terminal novo para usar a ferramenta, rode antes o comando de ativação. Quando o venv está ativo, costuma aparecer (venv) no início da linha — é o sinal de que está tudo certo.
O arquivo .env é onde as suas chaves "entram" no programa. Abra-o num editor de texto e preencha os dois campos. É o passo que liga a ferramenta às IAs.
# cole cada chave depois do = (sem aspas, sem espaços)
PERPLEXITY_API_KEY=pplx-1a2b3c4d5e6f7g8h9i0j...
GEMINI_API_KEY=AIzaSy1a2b3c4d5e6f7g8h9i0j...Substitua os exemplos pelas suas chaves reais. Salve o arquivo depois de editar.
Esse arquivo guarda as suas chaves em texto puro. Nunca o envie por e-mail, chat ou repositório público — quem o tiver pode gastar o seu crédito. Ele deve ficar só na sua máquina.
Antes de gastar qualquer centavo, vale fazer um teste de simulação. Ele confirma que a instalação e as chaves estão certas — sem fazer nenhuma chamada paga de IA.
# com o venv ativado
python -m strategy_factory.main run "Stripe" --dry-runA flag --dry-run simula a execução: nada é cobrado, nenhuma IA real é chamada.
Então está tudo certo: Python, ambiente e .env configurados. Você está pronto para o Módulo 1.3.
Volte ao tópico 6: provavelmente há um espaço sobrando, um nome de campo trocado ou o arquivo não foi salvo.
Se o dry-run passou, a ferramenta está instalada e configurada. No próximo módulo você roda de verdade — pela interface web, sem nenhum comando — e gera o seu primeiro relatório.
1.3 — Seu primeiro relatório (modo web) — suba a interface web e gere seu primeiro pacote de estratégia apontando e clicando, sem comandos.