CortexAcademic — Documentación

Plataforma de revisión sistemática con IA. Desde mapear el territorio científico hasta generar manuscritos PRISMA completos, validados por gobernanza epistémica.

PRISMA 2020 Governor epistémico Export Word/BibTeX CortexMap D3

Inicio rápido

Para comenzar una revisión sistemática en CortexAcademic:

Crea una cuenta en /register o inicia sesión en /login
Crea un nuevo proyecto desde el panel principal
Define tu PICO: Población · Intervención · Comparador · Outcome en Configuración PRISMA
Usa CortexMap para explorar el territorio de literatura
Importa referencias (BibTeX, RIS, texto plano) a tu Biblioteca
Ejecuta el Cribado IA para filtrar según tus criterios PRISMA
Genera el manuscrito final con S.A.G.E.

Consejo: El aislamiento por proyecto es automático. Cada proyecto tiene su PICO, biblioteca y análisis independientes.

Arquitectura

Capa	Tecnología	Rol
Frontend	Vue 3 CDN + D3.js	SPA renderizada en Flask templates
Backend	Python / Flask	API REST, rutas por módulo en `routes/`
Base de datos	PostgreSQL 16 + pgvector	Schema único `public`, aislamiento por `user_id + project_id`
LLM	Gemini / Gemma vía litellm	Todas las llamadas pasan por `governed_llm_call()`
Governor	CortexGovernor™	Jaccard + Coseno + Kalman. Elimina alucinaciones.

CortexMap

Grafo de literatura científica

CortexMap es la vista de exploración libre del territorio científico. Muestra papers como nodos en un grafo D3 interactivo, con aristas calculadas por similitud semántica.

Función	Descripción
Búsqueda seed	Ingresa un término — los top papers se convierten en nodos semilla
Expandir nodo	Clic en un paper → busca papers similares y los añade al grafo
Guardar a biblioteca	Botón "→ Refs" envía papers seleccionados a tu biblioteca del proyecto
Análisis PhD	13 dimensiones de análisis académico por paper
Controversia / Brechas	Sub-tabs con análisis de claims contradictorios y gaps de conocimiento

Líneas de Investigación

Módulo de exploración no dirigida. Introduce temas de interés (sin PICO previo) y el sistema genera intersecciones ontológicas entre constructos mediante grafos CAG (Redis) y búsqueda de corpus local.

Importante: Líneas de Investigación no usa el PICO existente intencionalmente — evita sesgo de confirmación en la exploración inicial.

PRISMA / Cribado

Flujo completo PRISMA 2020:

Configurar PICO en Configuración PRISMA
Importar referencias → la biblioteca las recibe automáticamente
Definir criterios de inclusión/exclusión
Ejecutar Cribado IA — el Governor valida cada decisión
Revisar y aprobar decisiones en el panel de elegibilidad

S.A.G.E. — Generación de Manuscrito

S.A.G.E. genera el manuscrito PRISMA completo sección por sección: introducción, métodos, resultados, discusión y conclusiones. Cada sección es validada por el Governor antes de mostrarse.

Flujo: Requiere PICO configurado + referencias cribadas en la biblioteca. El manuscrito se exporta en formato Word (.docx) o texto.

CortexGovernor™

Todo output de LLM pasa por la cadena de gobernanza antes de llegar al usuario:

Filtro Jaccard — ancla semántica al texto fuente (threshold ≥ 0.15)
GoldenThread + Dominio — vincula el PICO real como sustrato de verdad
Kalman Filter — estabiliza el SI durante el stream. Purga divergencias.
Registro SGO — cada llamada genera eventos en governance_events y corpus_entropy_snapshots

API REST

Todos los endpoints siguen el patrón /api/<módulo>/<acción>. Autenticación vía sesión Flask.

Módulo	Prefijo	Descripción
Biblioteca	`/api/library`	CRUD de referencias bibliográficas
PRISMA	`/api/prisma`	Configuración PICO, cribado, elegibilidad
CortexMap / LitMap	`/api/litmap`	Búsqueda, expansión, grafo
Theory Builder	`/api/theory`	Generación de teorías, hipótesis
S.A.G.E.	`/api/sage`	Generación y export de manuscrito
ALI	`/api/ali`	Análisis de literatura inteligente
Gobernanza	`/api/governor`	Dashboard KTMM, métricas Kalman

Configuración

Variables de entorno

GEMINI_API_KEY=your_key_here
LLM_MODEL=gemini/gemma-4-31b-it
DATABASE_URL=postgresql://cortex:password@localhost:5432/cortex_prod

Proveedor LLM

Configurable en Ajustes → Motor de IA. Soporta Google AI (Gemini/Gemma) y NVIDIA NIM (Nemotron 70B).

FAQ

¿Puedo tener múltiples proyectos?

Sí. Cada proyecto tiene PICO, biblioteca y análisis independientes. Cambia de proyecto activo desde el menú superior.

¿Los datos de mis proyectos son privados?

Absolutamente. El aislamiento es estricto: todo query filtra por user_id AND project_id. Ningún usuario puede ver datos de otro.

¿Qué modelos LLM usa la plataforma?

Por defecto Google Gemini/Gemma. También soporta NVIDIA NIM Nemotron 70B. Todas las llamadas están gobernadas — el LLM nunca llega directamente al usuario sin validación.

¿Cómo funciona el Governor?

Jaccard semántico ancla el output al texto fuente. El filtro Kalman detecta drift durante el stream. Si la divergencia supera el umbral, el segmento se purga. Ver el KTMM Monitor para métricas en tiempo real.