Update README.md

README.md

@@ -1,3 +1,76 @@
----
-license: cc-by-sa-4.0
----
+# BirdNET Geomodel V3.0.2
+
+Geographic species occurrence model from the [BirdNET](https://birdnet.cornell.edu/) project. Predicts which species are likely at a given location and time of year.
+
+
+ This Model was created by the BirdNET team and is maintained at https://github.com/birdnet-team/geomodel
+
+It is provided under an MIT license. 
+
+Suggested citation:
+```
+@misc{birdnet-geomodel,
+title={Spatiotemporal species occurrence prediction for post-filtering BirdNET acoustic detections},
+author={Kahl, Stefan and Mauermann, Max and Lasseck, Mario and Wood, Connor and Klinck, Holger},
+year={2026},
+url={https://github.com/birdnet-team/geomodel}
+}
+````
+
+This repository hosts the **ONNX FP32** variant 
+
+Details/readme copied largely from https://huggingface.co/tphakala/BirdNET-Geomodel/ 
+
+## Model Details
+
+- **Version**: V3.0.2
+- **Species**: 12,012 across 5 animal classes
+  - Birds: 11,157
+  - Mammals: 1,087
+  - Insects: 566
+  - Amphibians: 540
+  - Reptiles: 11
+- **Input**: `[latitude, longitude, week]` as float32 (shape `[1, 3]`)
+  - Latitude: [-90, 90]
+  - Longitude: [-180, 180]
+  - Week: BirdNET 48-week year (1-48, 4 weeks per month)
+- **Output**: 12,012 float32 species occurrence scores
+- **Format**: ONNX, FP16 precision
+- **Size**: 7.1 MB
+
+## Files
+
+| File | Description | Size |
+|------|-------------|------|
+| `birdnet-geomodel-v3.0-fp16.onnx` | BirdNET Geomodel v3.0 ONNX FP16 | 7.1 MB |
+| `birdnet-geomodel-v3.0-fp32.onnx` | BirdNET Geomodel v3.0 ONNX FP32 | 14.7 MB |
+| `BirdNET+_Geomodel_V3.0.2_Global_12K_Labels.txt` | Species labels (12,012 entries)
+
+### Labels format
+
+Tab-separated: `species_code`, `scientific_name`, `common_name`
+
+```
+1032549	Petaurista albiventer	White-bellied Giant Flying Squirrel
+zothaw	Buteo albonotatus	Zone-tailed Hawk
+```
+
+Line number corresponds to model output index (line 1 = index 0).
+
+## Source
+
+Original model from [birdnet-team/geomodel v3.0.2](https://github.com/birdnet-team/geomodel/releases/tag/v3.0.2).
+
+## License
+
+Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).
+
+See `MODEL_LICENSE.txt` for full terms including prohibited uses (poaching, military applications).
+
+Attribution: Powered by [BirdNET](https://birdnet.cornell.edu/).
+
+## Citation
+
+If you use this model in publications or presentations, please cite:
+
+> Powered by BirdNET (https://birdnet.cornell.edu/)