Create README.md

README.md

@@ -0,0 +1,61 @@
+---
+license: cc-by-nc-sa-4.0
+library_name: pytorch
+tags:
+  - histology
+  - neuroscience
+  - hippocampus
+  - bigbrain
+  - cell-segmentation
+  - density-estimation
+  - non-commercial
+---
+
+# CALHippo Model Weights
+
+This repository contains released model artifacts for the CALHippo framework,
+including segmentation, density-estimation, and classification components used
+by the public reproducibility path.
+
+## License and Terms of Use
+
+The CALHippo model weights in this repository are released under
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+(CC BY-NC-SA 4.0).
+
+These weights were trained and/or fine-tuned using BigBrain-derived
+histological data. They are intended for non-commercial academic research use
+only. Redistribution, adaptation, and sharing of derived versions must comply
+with CC BY-NC-SA 4.0 and with any applicable upstream dataset, model, and
+software licenses.
+
+This repository does not redistribute UNI2-h weights. UNI2-h is a gated upstream
+model distributed by MahmoodLab under its own access terms and license. Users
+who want to run the UNI2-h classification path must request access from the
+upstream provider and authenticate locally.
+
+## Included Artifacts
+
+```text
+density_estimation/
+  short_unet/
+    final_density_model.pth
+    *.yaml
+
+segmentation/
+  cellpose/
+    finetune_v4_astrocytes_big_brain
+  hovernet/
+    net_epoch=20.tar
+  instanseg/
+    instanseg.pt
+  stardist/
+    config.json
+    thresholds.json
+    weights_best.h5
+
+classification/
+  ml_classifier/
+    model.joblib
+    metadata.json
+    metrics.json