# CORTEX — checkpoints

Ce dossier contient les checkpoints **produits par Frankenstein-Labs**.

Rien n'y est versionné : les checkpoints sont des artefacts reproductibles, pas du code.
`.gitignore` exclut `*.pt`, `*.safetensors` et le contenu de ce dossier.

## Structure d'un checkpoint

```text
checkpoints/dev/
    step-500/
        config.json         hyper-paramètres du modèle
        weights.safetensors
        provenance.json     développeur, base_model, datasets, configuration
        manifest.json       tailles et SHA-256 de chaque fichier
    final/
        ...
```

## Vérification

```python
from model.init import load_cortex_checkpoint

model, config, provenance = load_cortex_checkpoint("checkpoints/dev/final")
print(config.model_name, provenance["step"], provenance["parameter_count"])
```

`load_cortex_checkpoint()` recalcule le SHA-256 de chaque fichier listé dans le manifeste
et refuse le checkpoint si un fichier manque, change de taille ou est corrompu.

## Distinction à conserver

Un checkpoint de ce dossier est un modèle **entraîné par Frankenstein-Labs**. Il n'a
aucun lien de dérivation avec les 66 shards distribués dans ce dépôt, qui proviennent de
DeepSeek-AI et restent inchangés. Le champ `base_model` de `provenance.json` vaut `null`
tant que c'est le cas.

Voir `docs/pipeline-cortex.fr.md` pour l'état réel du pipeline.