Upload README.md with huggingface_hub

README.md

@@ -1,11 +1,31 @@
+---
+language:
+- en
+license: mit
+tags:
+- bioacoustics
+- audio-classification
+- bird-sound-identification
+- pytorch
+- vision-transformers
+- protoclr
+- umap
+- hdbscan
+pipeline_tag: audio-classification
+library_name: pytorch
+metrics:
+- accuracy
+---
+
 # 🦅 Edge-Optimized Bioacoustic Atlas & Real-Time Avian Classifier
 
-[![Hugging Face Repository](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Repository-blue)](https://huggingface.co/sukriramli/tiny-bird-diffusion)
+[%F0%9F%93%93%20Open%20In%20Colab](https://colab.research.google.com/drive/1EL5VS_vAKvojPf5UPuQVFbK5gkgP51hB?usp=sharing)
+[![]_blue)](https://colab.research.google.com/drive/1EL5VS_vAKvojPf5UPuQVFbK5gkgP51hB?usp=sharing)
 [![Framework: PyTorch](https://img.shields.io/badge/Framework-PyTorch-ee4c2c?logo=pytorch)](https://pytorch.org/)
 [![Optimization: UMAP + HDBSCAN](https://img.shields.io/badge/Optimization-UMAP%20%2B%20HDBSCAN-green)]()
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A decoupled, ultra-lightweight machine learning pipeline designed for low-latency edge deployment, automated avian species tracking, and interactive audio streaming. 
+A decoupled, ultra-lightweight machine learning pipeline designed for low-latency edge deployment, automated avian species tracking, and interactive audio streaming.
 
 By leveraging **Prototypical Contrastive Learning (ProtoCLR)** backbones combined with advanced topological manifold compression (**UMAP & HDBSCAN**), this system projects complex audio waveforms onto a dense, 2D geometric map. The resulting production architecture handles **168 unique biological species** across **149 autonomous eco-acoustic clusters** natively in a client browser window with sub-second latency—completely bypassing the need for compute-heavy cloud inferencing heads.
 
@@ -32,4 +52,4 @@ Pre-trained foundation models are typically trained on pristine, studio-grade wi
 
 * `augment.py`: Digital Signal Processing (DSP) environment warping functions (Noise, Echo, Muffling filters).
 * `pipeline.py`: Low-latency engineering pipeline managing model configuration and UMAP coordinate projection.
-* `api.py`: Clean, production-ready prediction endpoint designed for real-time app integration.
+* `api.py`: Clean, production-ready prediction endpoint designed for real-time app integration.