Install and Extrasο
A quick guide to installing Zyra with optional extras. Use these to tailor your environment to the workflow stages you need.
Python Versionο
Requires Python 3.10+
Core Installο
Pip (core only):
pip install zyra
Poetry (dev):
poetry install --with dev
Stage-Focused Extrasο
connectors (import/export backends)
Pip:
pip install "zyra[connectors]"
Includes:
boto3
,requests
,PyVimeo
Enables: HTTP/S, FTP, S3, Vimeo
processing (GRIB2, NetCDF, GeoTIFF, FFmpeg helpers)
Pip:
pip install "zyra[processing]"
Includes:
cfgrib
,pygrib
,netcdf4
,xarray
,rioxarray
,rasterio
,siphon
,scipy
,ffmpeg-python
visualization (static plots/maps)
Pip:
pip install "zyra[visualization]"
Includes:
cartopy
,matplotlib
,xarray
,scipy
,pandas
,contextily
interactive (optional interactive visuals)
Pip:
pip install "zyra[interactive]"
Includes:
folium
,plotly
api (FastAPI service and optional job infra)
Pip:
pip install "zyra[api]"
Includes:
fastapi
,uvicorn
,python-multipart
,redis
,rq
all (everything above)
Pip:
pip install "zyra[all]"
Poetry equivalents (dev env)
connectors:
poetry install --with dev -E connectors
processing:
poetry install --with dev -E processing
visualization:
poetry install --with dev -E visualization
interactive:
poetry install --with dev -E interactive
api:
poetry install --with dev -E api
all:
poetry install --with dev --all-extras
Focused Extrasο
grib2 only:
pip install "zyra[grib2]"
netcdf only:
pip install "zyra[netcdf]"
geotiff export:
pip install "zyra[geotiff]"
Examplesο
Minimal heatmap (NetCDF input):
pip install "zyra[visualization]"
zyra visualize heatmap --input demo.nc --var T2M --output out.png
GRIB2 β NetCDF conversion:
pip install "zyra[processing]"
zyra process convert-format file.grib2 netcdf --stdout > out.nc
S3 copy (stdin/stdout friendly):
pip install "zyra[connectors]"
zyra acquire s3 --url s3://bucket/key -o - | zyra export s3 --url s3://other/key -i -
Notesο
Optional deps are large; install only what you need.
Many commands support
-
for stdin/stdout to enable streaming pipelines.Legacy terms:
datatransfer
(alias ofconnectors
),decimate
(alias ofexport
). Prefer the primary names in new docs.