Upload folder using huggingface_hub

.gitattributes

@@ -36,3 +36,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 assets/extrali_hero.png filter=lfs diff=lfs merge=lfs -text
 assets/org_banner.png filter=lfs diff=lfs merge=lfs -text
 assets/tone_axis.png filter=lfs diff=lfs merge=lfs -text
+assets/farm_map.png filter=lfs diff=lfs merge=lfs -text
+assets/model_profile.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -20,6 +20,24 @@ ModelFarm grows **personas inside small language models** and ships them as
 runtime that can turn the dose up and down *after* publication. Merged
 checkpoints forget who they are supposed to be; our packages remember.
 
+## The farm, mapped
+
+![The farm of AI models](assets/farm_map.png)
+
+Every crop is a person we grew on purpose. The moon is the base model — all crops share it.
+Field 001 (Extrali) is the public row; Field 002 (Arnold) is the gated pen; the nursery is
+where specimen 003 germinates. The scarecrow is the judge — persona-biased, and we say so.
+
+## The ModelFarm model profile
+
+Every model on the farm carries a **model profile** — one PNG, one standard, all real numbers:
+
+![Model profile format](assets/model_profile.png)
+
+The format: specimen photo, mechanism, dose window, axis position, identity-gate status,
+capability cost, gate status, and the keeper's notes. Swap the alien for your specimen —
+the template lives in the lab (`design/farm.html`).
+
 ## What the farm grows
 
 | package type | what it is | the honest catch |