Skip to content

English · Español

Lynx Cortex

A first-principles AI systems curriculum, built from zero to a working grammar tutor in 40 phases.

The model's entire universe is English verb grammar — 20 verbs, 5 tenses, 3 singular persons, paired with Spanish translations. Small enough to fit in your head; large enough to teach every layer of a modern LLM stack.

What is this?

A browsable rendering of the canonical curriculum under docs/. Every phase pairs theory, lab, and solutions in a fixed shape (see LYNX_CORTEX.md §7). NumPy first, hand-built second, framework last. No langchain. No llama-index. Ever.

Before you begin — Terms & Code of Conduct

Cortex University is a real but unaccredited program: its marks and certificate are valid within Cortex University's own standards (not ECTS), and the knowledge must be independently validated. Please read the Terms, Code of Conduct & Legal Statement — you accept it in the portal before a certificate is issued.

Start here

To boot the repo today (Phase 0):

git clone https://github.com/borjatarraso/lynx-cortex.git
cd lynx-cortex
just setup        # uv sync with Phase 0 extras + pre-commit + pre-push hook
just lint         # ruff + ruff format --check + mypy on src/
just test         # pytest -q
just docs-serve   # renders this site at http://127.0.0.1:8000 (≈60 s first build)

Then read in this order:

End-state preview (Phase 39)

This is the destination, not the on-ramp

The block below is what the final phase will ship. The just demo recipe is a Phase 39 deliverable and does not exist yet. To start the curriculum today, use Start here above.

git clone https://github.com/borjatarraso/lynx-cortex.git
cd lynx-cortex
uv sync --frozen
just demo                  # bring up the stack and run acceptance checks

A successful run ends with the Phase 39 acceptance table — twenty DE-NNN checks, all green:

=================================================================
                  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.

Explore

  • Curriculum

    Forty phases from transistors to a deployed grammar tutor. Each phase: motivation, theory, lab, solutions, report.

    Phase 00 — Foundations

  • Learner Portal

    Phase 41 designs an optional multi-student portal with passwordless onboarding, journals, quizzes, and spaced repetition.

    Phase 41 — Learner Portal

  • Threat model

    Security is threaded throughout, not bolted on. Phase 37 closes with prompt-injection, RAG injection, jailbreaks, and supply-chain verification labs.

    Phase 37 — Security & Safety

Why this repo exists

Most AI tutorials drop you into a framework on page one and never let you out. Lynx Cortex inverts that: it forces you to build the substrate before you abstract over it. You write a scalar autograd before you touch PyTorch. You hand-roll BPE before you load a tokenizer. You measure a roofline before you talk about flash attention. The grammar-tutor scope is microscopic on purpose — it lets every internal can be examined.

How it's organized

Path What lives there
docs/phase-NN-*/ Canonical curriculum: theory, lab, solutions, notebooks, diagrams, PHASE_NN_REPORT.md.
src/<module>/ Production code. Each module starts with BLUEPRINT.md.
tests/ pytest with autouse seed fixture; determinism is enforced.
learners/<name>/ Per-learner workspace (journals, attempts, reflections). Not part of this site.
security/ Threat model and supply-chain rules.
experiments/<date>-<topic>/ Versioned runs with manifest.json (versions + seed + config).

Recent changes

See Changelog for a chronological feed of structural decisions.

🇪🇸 Política bilingüe. Toda la documentación canónica, identificadores, nombres de fichero y mensajes de commit están en inglés. Los resúmenes en español aparecen como callouts cortos (1-3 líneas) prefijados con > 🇪🇸 en pasajes especialmente densos. Ver CLAUDE.md §0.6.