METAMATEMÁTICO — Razonamiento Formal con Lean 4

Leonardo Jiménez Martínez · BIOMAT · Centro de Biomatemáticas

---

Índice

1. Qué es este sistema
2. El cerebro formal: NLE + Lean 4
3. Sistema Multi-Agente: Jerarquía de Joins
4. Memory Evolutive Systems (MES)
5. Red Neuronal GNN + PPO
6. Co-Reguladores
7. Cómo funciona: flujo completo de una consulta
8. Tests
9. Datasets
10. Aplicación Web
11. Entrenamiento
12. Estructura del Repositorio
13. Instalación
14. Fundamento Teórico

---

1. Qué es este sistema

Metamatemático es un asistente de razonamiento matemático formal. A diferencia de un LLM convencional que genera texto plausible, este sistema verifica matemáticamente cada respuesta antes de producirla.

El núcleo se llama NLE v7.0 (Núcleo Lógico Evolutivo). Combina cuatro disciplinas en una arquitectura donde el LLM es solo la interfaz de lenguaje, mientras que el NLE y Lean 4 constituyen el cerebro formal:

Componente	Rol
NLE (Núcleo Lógico Evolutivo)	El cerebro: clasifica la consulta, activa el agente especializado del área, ordena las tácticas Lean, aprende de cada interacción y coordina todo el sistema
Lean 4	El juez formal: verifica que la afirmación matemática sea correcta. Su veredicto es inapelable
LLM (Claude, DeepSeek, Gemini…)	La boca: formaliza la consulta en Lean y traduce el resultado verificado a lenguaje natural. No razona por sí solo

Principio fundamental: el LLM nunca produce matemáticas directamente. Toda respuesta matemática — sea una demostración, una definición, o una explicación conceptual — pasa por Lean antes de llegar al usuario.

---

2. El cerebro formal: NLE + Lean 4

Por qué Lean como fuente de verdad

Los modelos de lenguaje pueden generar demostraciones que suenan correctas pero contienen errores sutiles (incluyendo errores de tipos en definiciones categóricas como la evaluación en una CCC). Lean 4 es un lenguaje con tipos dependientes que actúa como verificador: si compila sin errores, la demostración o definición es matemáticamente correcta.

Este sistema garantiza que el LLM nunca pueda inventar matemáticas porque su rol está arquitecturalmente limitado a:

1. Escribir código Lean (formalizar) — antes de que Lean lo verifique
2. Traducir el resultado de Lean a palabras — después de que Lean lo verifique

Dos tipos de formalización

El sistema distingue automáticamente entre preguntas que piden una prueba y preguntas que piden una definición:

Tipo de query	Qué genera Lean	Ejemplo
Prueba	theorem / lemma con táctica	"Demuestra que √2 es irracional"
Definición	#check / structure / class	"¿Qué es una CCC?"

Para definiciones, el sistema genera código como:

import Mathlib.CategoryTheory.Closed.Cartesian
#check CartesianClosed
-- eval : B^A × A → B  (no C^A — el exponencial es B^A)
#check CategoryTheory.CartesianClosed.curry
-- curry : Hom(C × A, B) ≅ Hom(C, B^A)

Lean confirma que estos tipos existen en Mathlib. El LLM entonces explica exactamente lo que Lean mostró — sin margen para inventar tipos incorrectos.

SolverCascade con táctica por área (domain_tactic)

Cuando la formalización contiene sorry, el sistema no intenta las tácticas en orden fijo. El ColimitAgent del área detectada aporta la táctica con mayor probabilidad de éxito para ese dominio matemático, que se coloca primera en la cascada:

classify_query("Demuestra que todo grupo abeliano es conmutativo")
  → área: "algebra"
  → domain_default_tactic("algebra") = "ring"

GoalAnalyzer.prioritize(goal, domain_tactic="ring")
  → ["ring", "rfl", "simp", "linarith", "nlinarith", "omega", "exact?", "apply?", "aesop"]

Área	Táctica por defecto
algebra	ring
number-theory	norm_num
logic	tauto
optimization	linarith
lean-tactics	simp
computation	decide
topology / analysis	continuity

Garantía anti-redundancia (skip_cascade)

Si try_fill_sorry_smart ya intentó los N solvers en orden inteligente y falló, el sistema no repite los mismos N solvers en fill_sorry_with_cascade. El flag skip_cascade=True hace que el segundo paso vaya directamente a la generación de candidatos LLM, evitando 2N intentos cuando N son suficientes.

---

3. Sistema Multi-Agente: Jerarquía de Joins

Principio 3.1 — Separación proceso/objeto

El agente ENVUELVE el join — no ES el join.

El join (colímite en la categoría thin G del grafo) es un objeto matemático verificado por is_join(). El agente es un proceso computacional que gestiona ese objeto. Esta distinción es fundamental:

• La propiedad universal (cota superior mínima) la satisface el nodo del grafo
• El agente selecciona tácticas, consulta la memoria MES, actualiza pesos PPO
• El reclamo matemático recae sobre el join; el agente es su envoltorio operativo

El sistema tiene 19 join-envoltorios en 3 niveles:

L3: 1 Orchestrator         ← join-envoltorio del sistema completo
       ↑
L2: 14 join-envoltorios    ← uno por área matemática (algebra, topology, …)
       ↑
L1:  4 PillarAgents        ← ZFC · CatThy · Logic · TypeThy
       ↑
L0: 76 skills atómicos     ← los objetos del grafo (no agentes)

La jerarquía de 4 niveles

L0: 76 skills atómicos (fundamentos + dominios + estrategias)
    ┌──────────────────────────────────────────────────────┐
    │  ZFC (8)  │  CatThy (8)  │  Logic (7)  │  TypeThy (8) │  (10 L0)
    │  + 66 skills de dominio distribuidos en 14 categorías  │
    └──────────────────────────────────────────────────────┘
         │  co-conos verificados por is_join()
         ▼
L1: 4 PillarAgents  — join-envoltorios de sus skills L0
    join[ZFC]    join[CatThy]    join[Logic]    join[TypeThy]

    Cada pilar inyecta morfismos (peso 0.8) en las categorías que fundamenta.
         │  morfismos L1 → L2
         ▼
L2: 14 join-envoltorios de área
    join[algebra]         join[analysis]        join[category-theory]
    join[combinatorics]   join[computation]     join[geometry]
    join[lean-tactics]    join[logic]           join[number-theory]
    join[optimization]    join[probability]     join[proof-strategies]
    join[set-theory]      join[topology]
         │  co-conos hacia L3
         ▼
L3: Orchestrator  — join-envoltorio de los 14 joins de área

Qué pilares fundamentan cada área

Pilar L1	Áreas L2 que nutre	Por qué
ZFC	algebra, set-theory, combinatorics, number-theory, probability, analysis	Toda la matemática clásica se construye sobre conjuntos
Teoría de Categorías	category-theory, topology, algebra, analysis	Espacios topológicos, funtores y trans. naturales son objetos categóricos
Lógica (FOL+IL)	logic, proof-strategies, lean-tactics, computation, set-theory	Las reglas de deducción dependen de la lógica formal
Teoría de Tipos (Curry-Howard)	lean-tactics, proof-strategies, computation, logic	Lean 4 está basado en CIC — las pruebas son programas

Cómo un join-envoltorio selecciona una táctica

select_tactic(query) sigue 5 pasos en cascada:

Paso	Fuente	Descripción
1	Memoria procedimental	Hash exacto de la query: si este problema fue resuelto antes, devuelve la táctica exitosa
2	Morfismo mediador	Si otro agente resolvió una query similar con táctica compartida, está en _mediating_memory
3	Co-cono ponderado	Activa skills relevantes ponderados por peso de morfismo hacia el join
4	Señal de pilar (L1→L2)	Lee morfismos L1→L2, detecta keywords del pilar dominante
5	domain_default_tactic	Tabla estática por área: algebra→ring, number-theory→norm_num, etc.

MES Bridge — extensión del grafo y skills emergentes

join-env[algebra]  ──→┐
join-env[number-theory]→┤ MES Bridge
join-env[...]      ──→┘
                        │
              record_success(query, tactic, reward)
                        │
               ┌────────┴────────┐
               │                 │
         ProceduralMemory    PatternManager
         por área            detecta convergencia:
         (O(1) lookup)       ¿2+ agentes resolvieron
                             la misma query?
                                 │
                                 ▼
                          ColimitBuilder
                          is_join() verifica
                          propiedad universal
                          → nuevo nodo en G_t
                          (extensión del grafo)

---

4. Memory Evolutive Systems (MES)

Los Memory Evolutive Systems (Ehresmann) modelan cómo el conocimiento crece manteniendo coherencia estructural.

Los tres conceptos clave

Patrón P: I → K Selección de skills relevantes para un tipo de problema. Funtor de una categoría índice I hacia el grafo K.

join[P] — cota superior mínima verificada El join del patrón en la categoría thin G es el skill emergente que los sintetiza. is_join() verifica explícitamente la propiedad universal: todo objeto que recibe morfismos de todos los componentes del patrón se factoriza de manera única a través de join[P].

Nota: el reclamo matemático es que join[P] es la cota superior mínima en la subcategoría thin finita G_n (~76-100 skills). No se reclama colímite en el sentido de CategoryTheory.Limits.IsColimit de Mathlib — esa conexión formal es trabajo futuro.

Extensión del grafo K' Cuando el sistema añade join[P] con sus co-conos, el grafo pasa de K a K'. El conocimiento crece sin destruir la estructura anterior.

Axiomas implementados y Teoremas verificados

Axioma/Teorema	Descripción	Suite de tests
8.1 Jerarquía	Skills en niveles L0 < L1 < L2	test_patterns.py
8.2 Multiplicidad	Un skill puede pertenecer a múltiples patrones	test_patterns.py
8.3 Conectividad	Los patrones son conexos en el grafo	test_patterns.py
8.4 Cobertura	Los pilares cubren todas las categorías	test_pillar_agents.py
8.5 Emergencia	Si el patrón existe, el join existe y es único	test_colimit_agents.py
8.6 Absorción	Nuevos skills se integran sin destruir joins previos	test_colimit_agents.py
8.7 Mediación	Entre dos joins con solución común existe morfismo mediador único	test_colimit_agents.py

Memoria procedimental

Sembrada inicialmente con 2,371 patrones de ProofNet y NuminaMath. Crece con cada interacción:

{
    "query_text": "prove that n^2 + n is even",
    "tactic_used": "omega",
    "lean_goal": "⊢ ∀ n : ℕ, 2 ∣ n^2 + n",
    "reward": 1.0,
    "category": "number-theory"
}

---

5. Red Neuronal GNN + PPO

Arquitectura

Entrada: query (texto) + grafo de skills (PyG)
         │
         ▼
  encode_query()          encode_goal()
  TF-IDF → 256-dim        "prove ..." → 128-dim
         │                      │
         └──────────┬───────────┘
                    │  concat → 384-dim
                    ▼
  SkillGNN (propaga información por morfismos del grafo):
    node_proj  →  feat_dim × 64
    GATConv 1  →  64  × 256  × 4 heads   ~  66,560 params
    GATConv 2  →  256 × 256  × 4 heads   ~ 262,144 params
    GATConv 3  →  256 × 256  × 4 heads   ~ 262,144 params
    out_proj   →  256 × 128              ~  32,896 params
                    │  graph_embedding 128-dim
  ActorCriticNetwork:
    shared_net →  384 × 256 × 128        ~ 148,736 params
    actor 128×3 · critic 128×1
    ▼
  Acción:  ASSIST_LEAN | RESPOND_DIRECT | REQUEST_CLARIFICATION

Total: 546,820 parámetros — 2.2 MB

Resultados de entrenamiento

Fase 1 — Supervisado:

Métrica	Resultado
Dataset	52,237 train · 6,552 val · 12,874 test
train_acc / val_acc / test_acc	100% / 100% / 100%

Fase 2 — PPO con recompensas reales de Lean (5 épocas, RTX 3050):

Época	Loss	Avg Reward
1	0.0746	0.573
5	0.0172	0.578

El reward ~0.57 refleja la distribución real: ~70% aritmética (norm_num +1.0) y ~30% álgebra abstracta (+0.5).

Aprendizaje vivo

Cada interacción actualiza el sistema:

Consulta → join-env selecciona táctica → Lean verifica
         → record_result(reward)
         → memoria procedimental actualizada
         → Transition → buffer PPO
         → cada 10 interacciones: agent.update() + save weights

---

6. Co-Reguladores

4 co-reguladores controlan el flujo antes de llegar a los join-envoltorios:

Co-regulador	Umbral	Función
TACTICAL (CR_tac)	80% del tráfico	Clasifica la consulta: ¿pipeline Lean-primero o respuesta directa?
ORGANIZATIONAL (CR_org)	Multi-paso	Organiza secuencia de tácticas en demostraciones largas
STRATEGIC (CR_str)	20% del tráfico	Decide estrategia global: backward reasoning, casos, inducción
INTEGRATIVE (CR_int)	Resultados parciales	Integra sub-demostraciones en una prueba coherente

---

7. Cómo funciona: flujo completo de una consulta

El principio fundamental

NLE + Lean = cerebro. LLM = boca.

El LLM formaliza (antes de Lean) y traduce (después de Lean). Nunca razona por sí solo. Esto elimina la posibilidad de que el LLM alucine definiciones o tipos incorrectos, porque la respuesta final debe ser consistente con lo que Lean verificó.

 ┌──────────────────────────────────────────────────────────────────────┐
 │  USUARIO: "¿Qué es una CCC?" / "Demuestra que √2 es irracional"      │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 1 — ¿Es matemática?                                            │
 │  80+ palabras clave, símbolos Unicode (∀∃∈ℝ), LaTeX, acentos        │
 │  Funciona en español e inglés.                                       │
 │  NO → respuesta directa LLM (saludo, pregunta general)               │
 │  SÍ → Paso 2                                                         │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 1b — ¿Es una demostración EXPLÍCITAMENTE geométrica/visual?    │
 │  ("demostración geométrica", "al estilo de Euclides", etc.)          │
 │  SÍ → respuesta educativa enriquecida (único bypass de Lean)         │
 │  NO → pipeline NLE+Lean (pasos 2–8)                                  │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 2 — Co-Reguladores votan la estrategia                         │
 │  CR_tac · CR_org · CR_str · CR_int → acción: ASSIST o RESPONSE       │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 3 — Clasificación de área y join-envoltorio especializado      │
 │                                                                      │
 │  classify_query(text) → área (14 categorías, español + inglés)       │
 │  domain_default_tactic(área) → táctica prioritaria para SolverCascade│
 │                                                                      │
 │  "¿Qué es una CCC?"          → area: "category-theory"              │
 │  "Demuestra √2 irracional"   → area: "number-theory"                │
 │  "Minimizar función convexa" → area: "optimization"                  │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 4 — ¿Prueba o Definición?                                      │
 │                                                                      │
 │  "qué es", "define", "explícame" → path DEFINITIONAL                 │
 │  "demuestra", "prueba", "verifica" → path PRUEBA                     │
 └──────────┬───────────────────────────┬─────────────────────────────-┘
            │ DEFINITIONAL              │ PRUEBA
            ▼                           ▼
 ┌────────────────────┐     ┌───────────────────────────────────────────┐
 │  LLM genera:       │     │  LLM genera theorem/lemma con sorry       │
 │  #check / struct.  │     │  Guardia anti-tautología activa           │
 │  de Mathlib        │     │  Ejemplos few-shot de miniF2F             │
 │  Refs hardcoded:   │     │  Refs hardcoded de teoremas clásicos      │
 │  • CartesianClosed │     │                                           │
 │  • eval:B^A×A→B    │     │                                           │
 │  • Functor, Group… │     │                                           │
 └──────────┬─────────┘     └──────────────────┬────────────────────────┘
            │                                  │
            └──────────────┬───────────────────┘
                           ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 5 — Lean 4 verifica el código                                  │
 │                                                                      │
 │  ✅ ÉXITO (SUCCESS)  → confianza 95%                                 │
 │  ⚠  SORRY           → SolverCascade con domain_tactic primero       │
 │  ❌ ERROR            → diagnóstico estructurado de tipo de error     │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 5b — SolverCascade (solo si hay sorry)                         │
 │                                                                      │
 │  try_fill_sorry_smart(domain_tactic=táctica_del_área)               │
 │  Orden: [táctica_área, rfl, simp, ring, linarith, omega, aesop]     │
 │  Si falla → fill_sorry_with_cascade(skip_cascade=True)              │
 │           → candidatos LLM (sin repetir los mismos N solvers)       │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 6 — LLM traduce lo que Lean verificó                           │
 │                                                                      │
 │  Para PRUEBA:                     Para DEFINICIÓN:                   │
 │  ## ¿Qué dice este resultado?     ## Definición formal               │
 │  ## ¿Cómo lo demuestra Lean?      ## Intuición                       │
 │  ## ¿Por qué es correcto?         ## Propiedades clave               │
 │                                   ## En Lean / Mathlib               │
 │                                                                      │
 │  CRÍTICO: la explicación debe ser CONSISTENTE con los tipos          │
 │  del código Lean. Si Lean dice eval:B^A×A→B, la explicación         │
 │  dice eval:B^A×A→B — no puede inventar otro tipo.                   │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  RESPUESTA AL USUARIO                                                │
 │                                                                      │
 │  [Explicación en lenguaje natural, consistente con Lean]             │
 │  ─────────────────────────────────────────────────────               │
 │  Lean 4 ✓ — definición verificada formalmente · área: category-theory│
 │                                                                      │
 │  ```lean                                                             │
 │  import Mathlib.CategoryTheory.Closed.Cartesian                      │
 │  #check CartesianClosed  -- eval : B^A × A → B                      │
 │  ```                                                                 │
 └──────────────────────┬───────────────────────────────────────────────┘
                        │
                        ▼
 ┌──────────────────────────────────────────────────────────────────────┐
 │  PASO 7 — Aprendizaje y memoria MES                                  │
 │  Resultado → reward → PPO buffer → memory.json                       │
 │  Los pesos se actualizan cada 10 interacciones                       │
 └──────────────────────────────────────────────────────────────────────┘

---

8. Tests

python -m pytest tests/ -o "addopts=" -v

382 tests en 18 suites, organizadas por subsistema:

Suite	Tests	Qué verifica
test_colimits.py	28	Propiedad universal, co-conos, morfismo mediador
test_evolution.py	22	Extensión del grafo, snapshots, functores de transición
test_emergence.py	18	Links simples/complejos, detección de emergencia
test_multiplicity.py	15	Principio de multiplicidad (Principio 3.1)
test_co_regulators.py	20	4 CRs activos, E-equivalencia
test_gnn.py	25	SkillGNN forward pass, graph_to_pyg()
test_ppo.py	18	PPO update, GAE, clipping
test_lean.py	30	Cliente Lean 4, SolverCascade, sorry analyzer
test_memory.py	22	MES Memory, patrones procedimentales
test_live_learning.py	10	Chat → PPO → weights update ciclo completo
test_cli.py	10	python -m nucleo chat REPL
test_multi_agent.py	35	join-envoltorios, PillarAgent, MES Bridge, classify_query()
test_patterns.py	26	Axiomas 8.1–8.4, Teoremas 8.5–8.7, is_join()
test_math_domains.py	32	76 skills en 14 categorías
test_domain_tactic_pipeline.py	30	classify_query ES+EN, domain_default_tactic, GoalAnalyzer.prioritize, try_fill_sorry_smart, skip_cascade, pipeline completo
+ 3 suites auxiliares	~41	Config, types, eval, graph base

Los tests del pipeline de tácticas (test_domain_tactic_pipeline.py) verifican sin Lean instalado usando mocks del LeanClient.

---

9. Datasets

El sistema integra 5.4M+ ejemplos matemáticos de datasets públicos:

Dataset	Ejemplos	Categorías
OpenMathReasoning	3,201,061	algebra, number-theory, analysis, competition math
NuminaMath	859,494	algebra, combinatorics, number-theory, geometry
MetaMathQA	395,000	algebra, arithmetic
Autoformalization	327,000	lean-tactics (pares NL ↔ Lean)
OrcaMath	200,000	algebra, arithmetic
OpenR1Math	93,000	proof-strategies
LeanWorkbook + Proofs	54,000	lean-tactics (pruebas Lean reales)
BigBench Formal Fallacies	14,200	logic
HendrycksMath	12,500	algebra, calculus, statistics
OmniMath	4,400	IMO, APMO, Putnam
ProofNet	371	proof-strategies, lean-tactics
GSM8K + MATH + miniF2F	~21,000	aritmética, álgebra

---

10. Aplicación Web

La interfaz Streamlit permite usar el sistema sin escribir código:

pip install -r requirements.txt

# Windows: necesario para símbolos Unicode matemáticos
PYTHONIOENCODING=utf-8 streamlit run app.py

Abre en http://localhost:8501 · Demo en Streamlit Cloud disponible.

Proveedores LLM soportados

Proveedor	Modelos	Costo
Anthropic	Claude Haiku 4.5, Claude Sonnet 4.6	De pago
DeepSeek	deepseek-chat (V3), deepseek-reasoner (R1)	De pago (muy barato)
Google AI Studio	Gemini 2.0 Flash, Gemini 1.5 Pro	Gratis (con cuota)
Groq	Llama 3.3 70B, Mixtral 8x7B	Gratis
Demo	Contenido matemático local	Sin key

DeepSeek usa la API compatible con OpenAI (pip install openai) con base_url=https://api.deepseek.com. El modelo R1 (deepseek-reasoner) no acepta parámetro temperature — el sistema lo omite automáticamente.

Funcionalidades de la interfaz

Funcionalidad	Descripción
Chat multi-turno	Conversación continua. El contexto se sincroniza con la memoria interna del NLE.
Adjuntar archivos (📎)	Soporta .txt, .tex, .pdf. Pipeline de verificación matemática de 6 pasos.
Visualizaciones	Grafo de skills, embeddings t-SNE/PCA, diagrama MES, traza de prueba, árbol de agentes.
Verificador Lean 4	Editor Lean 4 interactivo con verificación en tiempo real.
Consultores Avanzados	Genera N artefactos matemáticos verificables: .lean, skeletons de demostración, scripts Python, puentes de verificación. Cada candidato se verifica en Lean y se rankea por puntuación.
Ejemplos rápidos	Botones preconfigurados: √2 irracional, Lema de Yoneda, Lean 4 directo, Curry-Howard.

Pestaña de Visualizaciones

Pestaña	Qué muestra
Grafo de Skills	76 nodos. Skills activados: amarillo. Dependencias: morado. Tácticas: verde.
Embeddings	t-SNE/PCA de los 76 skills. Estrellas naranjas = tus queries del chat.
Extensión del Grafo	Patrón P, join[P] verificado por is_join() y la estructura K' extendida.
Pipeline	Diagrama de flujo del sistema.
Agentes	Jerarquía de 19 join-envoltorios, métricas F1/F2, pesos cargados.

---

11. Entrenamiento

Etapa A — Balancear datasets

python scripts/balance_datasets.py --dry-run    # estadísticas sin escribir
python scripts/balance_datasets.py --target 5000

Etapa B — Entrenar los 14 join-envoltorios especializados

python scripts/train_multiagent.py --epochs 5
python scripts/train_multiagent.py --categories algebra number-theory logic --epochs 10
python scripts/train_multiagent.py --with-lean --ppo-epochs 3

Etapa C — Entrenar el GNN+PPO global

python scripts/prepare_training_data.py

# Fase 1: supervisado (~20 min en RTX 3050)
python scripts/train_gnn_ppo.py --epochs 10 --batch-size 256

# Fase 2: PPO con Lean real
python scripts/train_gnn_ppo.py --resume --with-lean --lean-samples 300 --epochs 0 --ppo-epochs 5

Etapa D — Sembrar la memoria procedimental

python scripts/seed_from_datasets.py   # 2,371 patrones → data/memory.json

---

12. Estructura del Repositorio

Metamatematico/
│
├── app.py                         # App Streamlit — interfaz de chat
├── pages/
│   ├── 1_Visualizaciones.py       # Grafos, embeddings, MES, traza de prueba
│   ├── 2_Verificador.py           # Verificador Lean 4 interactivo
│   ├── 3_Instalar_Lean.py         # Guía de instalación Lean 4 con verificación en vivo
│   └── 4_Consultores_Avanzados.py # Módulo experto: N artefactos .lean verificados + reranker
│
├── nucleo/                        # Núcleo Lógico Evolutivo (~13,500 LOC)
│   ├── core.py                    # Orquestador: Lean-first + multi-agente + domain_tactic + consultores
│   ├── config.py                  # Configuración centralizada
│   │
│   ├── multi_agent/               # Sistema multi-agente
│   │   ├── orchestrator.py        # MultiAgentOrchestrator (L3)
│   │   ├── colimit_agents.py      # join-envoltorios L2 + domain_default_tactic()
│   │   ├── pillar_agents.py       # PillarAgent (L1)
│   │   ├── specialized_agent.py   # SpecializedAgent: GNN+PPO + classify_query() ES+EN
│   │   └── mes_bridge.py          # MESBridge: convergencia → extensión del grafo
│   │
│   ├── graph/                     # Grafo categórico de skills
│   │   ├── category.py            # SkillCategory: nodos, morfismos, reachable_from()
│   │   ├── evolution.py           # Extensión del grafo, snapshots, functores de transición
│   │   └── math_domains.py        # 76 skills en 14 categorías
│   │
│   ├── mes/                       # Memory Evolutive Systems
│   │   ├── patterns.py            # Patrones, is_join(), propiedad universal verificada
│   │   ├── memory.py              # MES Memory: patrones procedimentales, snapshots
│   │   └── co_regulators.py       # 4 Co-reguladores activos
│   │
│   ├── rl/                        # Aprendizaje por refuerzo
│   │   ├── agent.py               # NucleoAgent: PPO + GAE + memoria procedimental
│   │   ├── gnn.py                 # SkillGNN: 3× GATConv + graph_to_pyg()
│   │   ├── networks.py            # ActorCriticNetwork (546K params)
│   │   └── mdp.py                 # MDP matemático
│   │
│   ├── lean/                      # Verificación formal Lean 4
│   │   ├── client.py              # LeanClient (subprocess, UTF-8, timeout)
│   │   ├── solver_cascade.py      # GoalAnalyzer + SolverCascade + try_fill_sorry_smart
│   │   ├── sorry_filler.py        # SorryFiller con skip_cascade
│   │   └── sorry_analyzer.py      # Análisis estructurado de pruebas incompletas
│   │
│   ├── llm/                       # Cliente LLM multi-proveedor
│   │   └── client.py              # Anthropic / Google / Groq / DeepSeek / Demo
│   │
│   ├── pillars/                   # Skills L0 fundacionales
│   │   ├── zfc.py                 # 8 skills ZFC
│   │   ├── category_theory.py     # 8 skills CatThy
│   │   ├── logic.py               # 7 skills Logic
│   │   └── type_theory.py         # 8 skills TypeThy
│   │
│   ├── consultores/               # Módulo experto opcional
│   │   ├── artifacts.py           # Dataclasses: Candidate, CandidateMetrics, ConsultingResult, RequestType
│   │   ├── master_prompt.py       # Prompt maestro con bloques %%MARKER%% parseables
│   │   ├── reranker.py            # score_and_rank(): Lean score + completitud + complejidad
│   │   └── orchestrator.py        # ConsultoresModule.process(): N candidatos → Lean → rerank
│   │
│   └── eval/
│       └── math_evaluator.py      # \boxed{} extraction, tolerancia numérica, sympy
│
├── MetamathProver/                # Pruebas Lean 4 verificadas
│   ├── ColimitVerifier.lean       # Cierre transitivo, soundness, completeness
│   └── JoinColimit.lean           # IsJoin ↔ co-cono + prop. universal, 0 sorry
│
├── scripts/                       # Entrenamiento y utilidades
├── data/                          # Datos generados (lean_examples.json versionado)
├── tests/                         # 382 tests en 18 suites
└── docs/                          # Paper NLE v7.0

---

13. Instalación

git clone https://github.com/metamatematico/Metamatematico---Razonamiento-Formal-con-Lean.git
cd Metamatematico---Razonamiento-Formal-con-Lean

conda create -n metamat python=3.10
conda activate metamat
pip install -r requirements.txt

Lean 4 + Mathlib (necesario para verificación real)

curl https://elan.lean-lang.org/elan-init.sh -sSf | sh
lake update   # descarga Mathlib (~20-30 min la primera vez)

Sin Lean instalado, el sistema funciona con el pipeline completo excepto la verificación formal — el badge mostrará Lean 4 ↯ en lugar de Lean 4 ✓.

Dependencias principales

torch>=2.0              # GNN + PPO
torch-geometric>=2.4    # GATConv, PyG
networkx>=3.0           # Grafo categórico
streamlit>=1.40         # Interfaz web
openai>=1.0             # DeepSeek (API compatible) + fallback
anthropic               # Anthropic Claude
numpy, scikit-learn, sympy

Lanzar

PYTHONIOENCODING=utf-8 streamlit run app.py   # interfaz web
python -m nucleo chat                          # CLI interactivo

---

14. Fundamento Teórico

El NLE v7.0 está basado en el artículo "Núcleo Lógico Evolutivo v7.0 — Memory Evolutive Systems y Razonamiento Formal" (Jiménez Martínez, BIOMAT 2025), disponible en docs/NLE_v7_PaperNN.pdf.

La intuición central

Un matemático experto no reapende álgebra de cero cada vez que resuelve un problema. Su conocimiento está organizado en competencias (skills) que se activan según el contexto, y cuando resuelve un problema nuevo, sintetiza competencias previas en una competencia emergente. Los Memory Evolutive Systems formalizan esta estructura.

La jerarquía L0→L1→L2→L3 refleja exactamente eso:

• L0 — axiomas (ZFC, lógica, tipos, categorías): el conocimiento más fundamental
• L1 — pilares: síntesis de los axiomas de cada fundamento
• L2 — áreas matemáticas: síntesis de skills de dominio + señales de pilares
• L3 — sistema completo: punto de entrada único

Cada nivel es el join (cota superior mínima verificada) del nivel anterior en la categoría thin del grafo. Esta es la implementación directa del Teorema de Complexificación de Ehresmann.

Por qué teoría de categorías

La teoría de categorías es el lenguaje natural de las matemáticas modernas: expresa relaciones entre estructuras con la misma precisión que las estructuras mismas. Usar categorías para organizar el conocimiento matemático es coherente con el dominio que el sistema maneja — no es una elección arbitraria, sino la misma formalización que los matemáticos usan para relacionar álgebra, topología, lógica y computación entre sí.

Limitaciones honestas

Reclamo	Estado
join[P] es cota superior mínima en G_n	✓ verificado por is_join() en Python
Conexión formal con CategoryTheory.Limits.IsColimit de Mathlib	Trabajo futuro
GNN entrenada para selección de tácticas dentro de Lean	Pendiente (actualmente: routing ASSIST/RESPOND)
Co-reguladores: analogías Python del formalismo MES categórico	Sin prueba formal completa

---

Leonardo Jiménez Martínez · BIOMAT · Centro de Biomatemáticas · 2025