Primeros pasos¶

Esta guía te lleva de cero a un entorno Belico funcionando: instalación de dependencias, configuración de claves de API académicas y tu primer build del pipeline. Es el punto de entrada recomendado si recién llegás.

¿Qué vas a lograr?

Al terminar este tutorial vas a tener el stack clonado, las dependencias instaladas, las credenciales configuradas y el primer engram conectó corriendo. A partir de ahí, Tu primer paper te muestra cómo arrancar un paper de verdad.

Prerequisitos¶

Dependencia	Versión mínima	Cómo verificar
Python	3.10+ (recomendado 3.12)	`python --version`
Git	2.30+	`git --version`
Pandoc	2.19+	`pandoc --version` (para compilar PDFs)
Engram	latest	`engram --version`

Plataformas

Windows: usá PowerShell 7+ (pwsh), no powershell.exe (v5). El stack expone scripts .ps1 modernos que fallan en la versión antigua.
OpenSeesPy en Windows: no funciona estable con Python 3.13 — usá Python 3.12 para el backend structural.
macOS/Linux: bash 4+ o zsh.

Paso 1 — Clonar el repositorio¶

git clone --recurse-submodules https://github.com/Mikisbell/Belico_Jarvis.git mi-paper
cd mi-paper

El flag --recurse-submodules es obligatorio: el stack incluye submódulos en .agents/. Si lo olvidaste:

git submodule update --init --recursive

Paso 2 — Configurar el entorno Python¶

python -m venv .venv
# Windows: .venv\Scripts\activate
# Linux/macOS: source .venv/bin/activate

pip install -e .

Esto instala el paquete belico con su CLI. Verificá:

belico --help
belico --version

Paso 3 — Configurar las API keys (`.env`)¶

Copiá el template y completá las claves:

cp .env.example .env

Las claves mínimas para el pipeline básico:

Variable	Para qué	Costo
`OPENALEX_API_KEY`	Búsqueda de literatura	Gratis (free tier sin key)
`SEMANTIC_SCHOLAR_API_KEY`	Style calibration	Gratis (recomendado)
`SUPABASE_URL` + `SERVICE_KEY`	reference_papers, patents	Opcional

Nunca commitees .env

El .env está en .gitignore. Si una key se te escapa, revocala inmediatamente y generá una nueva. Ver Gestión de API keys.

Paso 4 — Verificar conectividad¶

Antes de arrancar, confirmá que las APIs responden:

belico smoke-check

Si estás sin conexión o querés un chequeo rápido:

belico smoke-check --no-online

Paso 5 — Primera sesión: "engram conectó"¶

Abrí tu IDE (Claude Code recomendado — también funciona en Antigravity, Cursor, Windsurf, OpenCode) y decí exactamente:

engram conectó

El orquestador verifica dependencias, consulta Engram (constitución cacheada, papers activos, riesgos) e imprime un reporte del estado del stack. Luego te pregunta "¿Qué vamos a desarrollar?" (dominio + quartile + institución).

Siguientes pasos¶

Tu primer paper con la CLI — arrancá un paper end-to-end.
Setup del agente / IDE — configurá tu IDE y modelo preferido.
El pipeline de producción — entendé las 9 fases SDD.
Las reglas del stack — qué enforza Belico y por qué.

Fuente canónica

Este tutorial deriva de docs/shared/GETTING_STARTED.md, que mantiene la versión extendida con todos los pasos de init_child.