# alisakour/conditional-nca-digits architecture

> Architecture diagram of the GitHub repository alisakour/conditional-nca-digits, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alisakour/conditional-nca-digits
- Repository: https://github.com/alisakour/conditional-nca-digits

## Overview

This small research repository presents a conditional neural cellular automaton (NCA) for growing class-specific handwritten digits. The documented workflow is to condition the model on a digit class and generate a digit through morphogenesis; the README describes growth from a single pixel. The notebook is the only implementation source shown, and the repository also contains a trained checkpoint. No source excerpts were provided, so internal stages and the checkpoint’s loading path cannot be verified.

Main entry points: [`conditional-nca-implementation.ipynb`](https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb) (NCA model), [`c_nca_mnist.pth`](https://github.com/alisakour/conditional-nca-digits/blob/main/c_nca_mnist.pth) (Trained weights)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_model["Conditional NCA"]
  node_class_condition["Class condition"]
  node_nca["NCA model"]
  node_checkpoint["Trained weights<br/>[c_nca_mnist.pth]"]
  node_digit_growth["Digit growth"]
end

node_user(("User"))

node_user -->|"selects class"| node_class_condition
node_class_condition -->|"conditions"| node_nca
node_nca -->|"generates"| node_digit_growth
node_checkpoint -.->|"weights"| node_nca

click node_class_condition "https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb"
click node_nca "https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb"
click node_checkpoint "https://github.com/alisakour/conditional-nca-digits/blob/main/c_nca_mnist.pth"
click node_digit_growth "https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_class_condition,node_nca,node_checkpoint,node_digit_growth,node_user toneBlue
```

## Components

### Conditional NCA

- [Class condition](https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb): `conditional-nca-implementation.ipynb`
- [NCA model](https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb): `conditional-nca-implementation.ipynb`
- [Trained weights](https://github.com/alisakour/conditional-nca-digits/blob/main/c_nca_mnist.pth): `c_nca_mnist.pth`
- [Digit growth](https://github.com/alisakour/conditional-nca-digits/blob/main/conditional-nca-implementation.ipynb): `conditional-nca-implementation.ipynb`

### Other components

- **User**

## Connections

- User → Class condition: selects class (evidence: `README.md`)
- Class condition → NCA model: conditions (evidence: `README.md`)
- NCA model → Digit growth: generates (evidence: `README.md`)
- Trained weights → NCA model: weights
