README.md

---
license: apache-2.0
language:
- en
tags:
- mangrove
- blue-carbon
- climate
- satellite
- multimodal
- environmental-ai
library_name: transformers
pipeline_tag: text-generation
extra_gated_prompt: >-
  NatureCode Mangrove Model is designed for mangrove conservation, carbon accounting, 
  and environmental research. Access requires approval to ensure responsible use.
  Please describe your intended use case.
extra_gated_fields:
  Organization: text
  Use case: text
  I agree to use this model for conservation and research purposes: checkbox
---

# NatureCode Mangrove Model

A multimodal foundation model for mangrove ecosystem analysis, carbon estimation, and conservation planning.

**Website**: [naturecode.ai](https://naturecode.ai)

## Capabilities

- **Satellite Imagery Analysis**: Process 19-band multispectral satellite tiles (Sentinel-2, Landsat, Planet)
- **Environmental Timeseries**: Analyze water quality, temperature, salinity data
- **Carbon Estimation**: Calculate above-ground biomass and blue carbon stocks
- **Conservation Planning**: Generate site assessments and restoration recommendations

## Quick Start

```python
from naturecode import NatureCodeMangrove

model = NatureCodeMangrove.from_pretrained("naturecodeproject/mangrove")

response = model.generate(
    text="Analyze this mangrove site",
    image="site_tile.npz",
    coordinates=(4.5, 73.5)
)
```

## Supported Input Types

| Type | Formats |
|------|---------|
| Satellite | NPZ (19-band), GeoTIFF, NumPy array |
| Timeseries | CSV, DataFrame, NetCDF |
| Text | Natural language queries |
| Coordinates | (lat, lon) tuples |

## Model Architecture

- **Base**: Qwen3-1.7B with merged LoRA adapters
- **Vision Encoder**: DINOv2-B/14 with learned projector
- **Timeseries Encoder**: Custom transformer for environmental data
- **Training**: 5-phase curriculum on 50K global mangrove tiles

## License

Apache 2.0