# Canopy Viewer

NiceGUI app for creating canopy figures from JSON config. Select fields, configure options, and generate maps, time series, distributions, and more.

## Installation

**pip** (recommended):

```bash
pip install canopy-viewer
```

On Linux, add `[linux-native]` for native window support (no system packages needed):

```bash
pip install canopy-viewer[linux-native]
```

## Run

```bash
canopy-viewer
```

### Linux

On Linux, native mode needs Qt or GTK. If you see `WebViewException: You must have either QT or GTK...`:

**Option A – Run in browser** (no extra deps):

```bash
canopy-viewer --browser
```

**Option B – Native window via pip** (recommended):

```bash
pip install canopy-viewer[linux-native]
```