Ahora vamos a poner la herramienta en marcha en tu máquina. Este módulo es práctico y paso a paso: qué instalar antes, cómo obtener las dos claves de API gratuitas, dos formas de instalar (automática y manual), dónde pegar las claves y cómo confirmar que todo funcionó, sin gastar nada.
Diagrama ilustrativo — la instalación es una escalera de pocos pasos: descargar, crear el entorno, instalar, configurar las claves y listo.
Antes de ejecutar cualquier comando, reúne tres cosas. Tenerlas listas antes de empezar evita el error más común de principiante: quedarse atascado a mitad de la instalación porque faltaba algo básico.
El lenguaje que ejecuta la herramienta. Descárgalo en python.org/downloads.
Una de Perplexity y una de Gemini. Obtienes ambas en los próximos temas.
Símbolo del sistema en Windows; Terminal en Mac/Linux. Es donde escribes los comandos.
Al instalar Python en Windows, hay una casilla que es fácil pasar por alto y que causa la mitad de los problemas de quienes empiezan:
En la terminal, escribe python --version (o python3 --version). Si aparece 3.9 o superior, ya estás listo. Si da error, significa que falta instalarlo — o marcar la opción PATH.
La primera de las dos claves viene de Perplexity — la IA que realiza la investigación (Fase 1). Sin ella, no se genera ningún documento. El proceso tarda unos 2 minutos.
Abre perplexity.ai/settings/api en el navegador.
Es gratis para empezar. Inicia sesión con normalidad.
La clave aparece en pantalla. Empieza con pplx-. Cópiala y guárdala.
# formato (exemplo — a sua será diferente)
pplx-1a2b3c4d5e6f7g8h9i0j...Trata esta clave como una contraseña: quien la tenga puede gastar tu crédito.
Esta es la clave de la Fase 1 (Investigación). Si falta o es incorrecta, la herramienta ni siquiera llega a escribir los documentos: se detiene al principio con un error de clave.
La segunda clave viene de Google Gemini — la IA que redacta los documentos (Fase 2). Es gratis para empezar y puedes obtenerla en Google AI Studio con unos pocos clics.
Abre aistudio.google.com/apikey.
Te sirve la misma cuenta de Google que ya usas en el día a día.
La clave empieza con AIzaSy. Cópiala y guárdala junto con la otra.
Las claves provienen de sitios diferentes (Perplexity y Google) y cada una tiene su propio crédito. Ambas tienen un plan gratuito para que pruebes antes de gastar de verdad.
Con el proyecto descargado, hay un atajo que hace casi todo por ti: un solo comando. Es el camino recomendado para quien no quiere modificar cada etapa a mano.
# na pasta do projeto
python setup.pyEste comando inicia un asistente que prepara todo el entorno de una sola vez.
En algunas computadoras el atajo puede fallar (versión diferente de Python, permisos, etc.). No hay problema: el siguiente tema muestra la instalación manual, que realiza exactamente los mismos pasos, solo que uno por uno.
Si prefieres controlar cada paso — o si el proceso automático falló — puedes instalarlo manualmente. Son cuatro comandos simple. Además, entiendes lo que ocurre entre bambalinas.
# 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 .envEjecútalo en orden. El paso 2 cambia según tu sistema: usa solo la línea que corresponda.
Cada vez que abras una terminal nueva para usar la herramienta, ejecuta primero el comando de activación. Cuando el venv está activo, suele aparecer (venv) al inicio de la línea: es la señal de que todo está bien.
El archivo .env es donde tus claves «entran» en el programa. Ábrelo en un editor de texto y completa los dos campos. Es el paso que conecta la herramienta con las IA.
# cole cada chave depois do = (sem aspas, sem espaços)
PERPLEXITY_API_KEY=pplx-1a2b3c4d5e6f7g8h9i0j...
GEMINI_API_KEY=AIzaSy1a2b3c4d5e6f7g8h9i0j...Reemplaza los ejemplos por tus claves reales. Guarda el archivo después de editarlo.
Este archivo guarda tus claves en texto sin cifrar. Nunca lo envíes por correo electrónico, chat o repositorio público: quien lo tenga puede gastar tu crédito. Debe quedarse solo en tu máquina.
Antes de gastar un centavo, conviene hacer una prueba de simulación. Confirma que la instalación y las claves estén correctas — sin realizar ninguna llamada de IA de pago.
# com o venv ativado
python -m strategy_factory.main run "Stripe" --dry-runLa flag --dry-run simula la ejecución: no se cobra nada ni se llama a ninguna IA real.
Entonces está todo bien: Python, entorno y .env configurados. Estás listo para el Módulo 1.3.
Vuelve al tema 6: probablemente sobra un espacio, se cambió el nombre de un campo o no se guardó el archivo.
Si el dry-run salió bien, la herramienta está instalada y configurada. En el próximo módulo la ejecutarás de verdad — desde la interfaz web, sin ningún comando — y generarás tu primer informe.
1.3 — Tu primer informe (modo web) — inicia la interfaz web y genera tu primer paquete de estrategia con apuntar y hacer clic, sin comandos.