English · Español

Lynx Cortex¶

Un currículo de sistemas de IA (AI) desde primeros principios, construido de cero a un tutor de gramática operativo en 40 fases.

El universo entero del modelo es gramática verbal inglesa — 20 verbos, 5 tiempos, 3 personas singulares, emparejados con traducciones al español. Lo bastante pequeño para caber en la cabeza; lo bastante grande para enseñar cada capa de una pila moderna de LLM.

¿Qué es esto?

Una renderización navegable del currículo canónico bajo docs/. Cada fase combina teoría, lab y soluciones en una forma fija (ver LYNX_CORTEX.md §7). Primero NumPy, después construido a mano, framework al final. Sin langchain. Sin llama-index. Nunca.

Antes de empezar — Términos y código de conducta

Cortex University es un programa real pero no acreditado: sus notas y su certificado son válidos según los estándares propios de Cortex University (no ECTS), y el conocimiento debe validarse de forma independiente. Lee los Términos, código de conducta y declaración legal — los aceptas en el portal antes de que se emita un certificado.

Empieza aquí¶

Para arrancar el repositorio hoy (Fase 0):

git clone https://github.com/borjatarraso/lynx-cortex.git
cd lynx-cortex
just setup        # uv sync con los extras de la Fase 0 + pre-commit + hook pre-push
just lint         # ruff + ruff format --check + mypy en src/
just test         # pytest -q
just docs-serve   # renderiza este sitio en http://127.0.0.1:8000 (≈60 s la primera build)

Luego lee en este orden:

¿Primera vez? Fase 00 — Foundations — el entorno, las semillas, la disciplina. Todo lo demás se construye sobre ello.
El contrato. LYNX_CORTEX.md (spec autoritativo, traducción al español del original inmutable en inglés) + LYNX_CORTEX_ADDENDUM.md (enmiendas — §A13 fija el alcance a gramática verbal inglesa; §A17 amplía la política bilingüe).
¿Trabajando en el repositorio? CLAUDE.md + la guía de inicio.

Vista previa del estado final (Fase 39)¶

Esto es el destino, no la rampa de entrada

El bloque siguiente es lo que la fase final entregará. La receta just demo es un entregable de la Fase 39 y aún no existe. Para empezar el currículo hoy, usa Empieza aquí arriba.

git clone https://github.com/borjatarraso/lynx-cortex.git
cd lynx-cortex
uv sync --frozen
just demo                  # levanta la pila y ejecuta los checks de aceptación

Una ejecución exitosa termina con la tabla de aceptación de la Fase 39 — veinte checks DE-NNN, todos en verde:

=================================================================
                  Phase 39 — Acceptance Checks
=================================================================
| ID     | Check                                           | Pass |
|--------|-------------------------------------------------|------|
| DE-001 | Stack starts within 30 s                        |  v   |
| DE-002 | miniserve responds on :8080 within 5 s          |  v   |
| DE-003 | First request completes within 10 s             |  v   |
| DE-004 | p95 latency over 3-sentence battery < 5 s       |  v   |
| ...    | ...                                             | ...  |
| DE-020 | Demo exits with status 0                        |  v   |
=================================================================
Result: 20/20 passed.
=================================================================

🇪🇸 Si la tabla termina en verde, el currículo está cerrado. Hasta ese momento, cada fase añade una capa nueva sobre la anterior, sin saltos.

Explora¶

Currículo

Cuarenta fases desde transistores hasta un tutor de gramática desplegado. Cada fase: motivación, teoría, lab, soluciones, informe.

Fase 00 — Foundations
Portal del learner

La Fase 41 diseña un portal multi-estudiante opcional con onboarding sin contraseña, journals, quizzes y repetición espaciada.

Fase 41 — Learner Portal
Modelo de amenazas

La seguridad está hilada a lo largo del currículo, no añadida al final. La Fase 37 cierra con labs de prompt injection, RAG injection, jailbreaks y verificación de supply chain.

Fase 37 — Security & Safety

Por qué existe este repositorio¶

La mayoría de tutoriales de IA te tiran a un framework en la página uno y nunca te dejan salir. Lynx Cortex invierte eso: te obliga a construir el sustrato antes de abstraer sobre él. Escribes un autograd escalar antes de tocar PyTorch. Implementas BPE a mano antes de cargar un tokenizer. Mides un roofline antes de hablar de flash attention. El alcance del tutor de gramática es microscópico a propósito — permite que cada internal sea examinado.

Cómo está organizado¶

Ruta	Qué vive ahí
`docs/phase-NN-*/`	Currículo canónico: teoría, lab, soluciones, notebooks, diagramas, `PHASE_NN_REPORT.md`.
`src/<module>/`	Código de producción. Cada módulo arranca con `BLUEPRINT.md`.
`tests/`	`pytest` con autouse seed fixture; el determinismo está enforcado.
`learners/<name>/`	Workspace por learner (journals, intentos, reflexiones). No forma parte de este sitio.
`security/`	Modelo de amenazas y reglas de supply chain.
`experiments/<date>-<topic>/`	Ejecuciones versionadas con `manifest.json` (versiones + semilla + configuración).

Cambios recientes¶

Ver Changelog para un feed cronológico de decisiones estructurales.

🇪🇸 Política bilingüe. El currículo está espejado en inglés (X.md) y español (X.es.md) — ambos son igualmente autoritativos. Los identificadores de código, rutas, comandos y mensajes de commit permanecen en inglés. Ver CLAUDE.md §0.6 y LYNX_CORTEX_ADDENDUM.md §A17 para la política completa.