CREDIT

An open software platform to train and deploy AI atmospheric prediction model.
https://github.com/ncar/miles-credit

Category: Atmosphere
Sub Category: Meteorological Observation and Forecast

Keywords from Contributors

grib weather hugo

Last synced: about 6 hours ago
JSON representation

Repository metadata

NCAR MILES Community Research Earth Digital Intelligence Twin (CREDIT): research platform for ML Earth system prediction models.

README.md

NSF NCAR MILES Community Research Earth Digital Intelligence Twin (CREDIT)

DOI

PyPI

CREDIT npj Climate and Atmospheric Science Article

About

CREDIT is an open software platform to train and deploy AI atmospheric prediction models. CREDIT offers fast models
that can be flexibly configured both in terms of input data and neural network architecture. The interface is designed
to be user-friendly and enable fast spin-up and iteration. CREDIT is backed by the AI and atmospheric science expertise
of the MILES group and the NSF National Center for Atmospheric Research, leading to design choices that balance advanced
AI/ML with our physical knowledge of the atmosphere.

CREDIT has reached its first stable release with a full set of models, training, and deployment options. It continues
to be under active development. Please contact the MILES group if you have any questions about CREDIT.

New to CREDIT? See QUICKSTART.md to get up and running locally, or the full online Quickstart for detailed guidance.

AI assistant

credit ask is a unified AI assistant — it automatically runs in agent mode (reads your
files, runs shell commands, iterates until it has a confident answer) when an Anthropic key
is available, or falls back to simple chat (Groq, OpenRouter, Gemini, or OpenAI) otherwise.

pip install "miles-credit[ask]"

# Free — no card needed (pick either)
export GROQ_API_KEY=gsk_...          # https://console.groq.com
export OPENROUTER_API_KEY=sk-or-...  # https://openrouter.ai

# Or use your own Anthropic key for full agent mode (~$0.01–0.05/session)
export ANTHROPIC_API_KEY=sk-ant-...  # https://console.anthropic.com

credit ask "why is my loss not decreasing?"
credit ask -c my_run.yml "why did my training run crash?"

The assistant picks the first provider with an available API key. Supported keys:

Env var Provider / model Mode
ANTHROPIC_API_KEY Anthropic (Claude) full agent mode
GROQ_API_KEY Groq (Llama 3, free) simple chat
OPENROUTER_API_KEY OpenRouter (Qwen3-Next-80B, free) simple chat
GOOGLE_API_KEY Google (Gemini) simple chat
OPENAI_API_KEY OpenAI (GPT-4o) simple chat

See the AI Assistant documentation for the full reference.

MILES CREDIT also provides more detailed documentation with installation
instructions, how to get started training and deploying models, how to interpret the config files, and full API docs.

Citing CREDIT

If you are interested in using CREDIT as part of your research, please cite the following paper:
Schreck, J.S., Sha, Y., Chapman, W. et al. Community Research Earth Digital Intelligence Twin: a scalable framework
for AI-driven Earth System Modeling. npj Clim Atmos Sci 8, 239 (2025). https://doi.org/10.1038/s41612-025-01125-6

Model Weights and Data

Model weights for the CREDIT 6-hour WXFormer and FuXi models and the 1-hour WXFormer are available on huggingface.

Processed ERA5 Zarr Data are available for download through Globus (requires free account) through the CREDIT ERA5 Zarr Files collection.

Scaling/transform values for normalizing the data are available through Globus here.

CREDIT also supports realtime runs generated from deterministic Google Cloud GFS files
and raw cube sphere GEFS files.

Support

This software is based upon work supported by the NSF National Center for Atmospheric Research, a major facility sponsored by the
U.S. National Science Foundation under Cooperative Agreement No. 1852977 and managed by the University Corporation for Atmospheric Research. Any opinions, findings and conclusions or recommendations
expressed in this material do not necessarily reflect the views of NSF. Additional support for development was provided by
The NSF AI Institute for Research on Trustworthy AI for Weather, Climate, and Coastal Oceanography (AI2ES) with grant
number RISE-2019758 and by Schmidt Sciences, LLC.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 2,530
Total Committers: 29
Avg Commits per committer: 87.241
Development Distribution Score (DDS): 0.777

Commits in past year: 1,169
Committers in past year: 19
Avg Commits per committer in past year: 61.526
Development Distribution Score (DDS) in past year: 0.738

Name Email Commits
John Schreck j****k@g****m 564
Yingkai Sha y****a@g****m 511
David John Gagne d****e@g****m 485
charlie-becker c****r@u****u 183
Seth McGinnis m****s@u****u 148
kevinyang-cky k****g@u****u 138
danineamati d****i@g****m 112
willychap w****n@u****u 85
dkimpara d****a@u****u 51
dkimpara d****a@g****m 50
Katelyn FitzGerald 7****d 47
Negin Sobhani n****3@g****m 33
Arnold Kazadi a****o@g****m 23
pre-commit-ci[bot] 6****] 16
dependabot[bot] 4****] 15
sgpearse p****e@u****u 13
ggantos g****s@u****u 13
Ben Kirk b****k@u****u 8
ILoveSorasakiHina d****8@g****m 7
Stanley Akor s****r@c****u 6
Stanley Akor s****r@c****u 6
Stanley Akor s****r@c****u 4
Nihanth Wagmi Cherukuru n****u@u****u 3
Jay Rothenberger 3****r 3
Stanley Akor s****r@u****u 2
Ethan Campbell 2****4 1
“kjmayer” “****r@u****” 1
Stanley Akor s****r@c****u 1
Sai Asish Y s****5@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 88
Total pull requests: 261
Average time to close issues: 3 months
Average time to close pull requests: 10 days
Total issue authors: 20
Total pull request authors: 22
Average comments per issue: 1.14
Average comments per pull request: 1.07
Merged pull request: 200
Bot issues: 0
Bot pull requests: 9

Past year issues: 68
Past year pull requests: 89
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 12 days
Past year issue authors: 15
Past year pull request authors: 16
Past year average comments per issue: 1.12
Past year average comments per pull request: 2.09
Past year merged pull request: 59
Past year bot issues: 0
Past year bot pull requests: 9

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ncar/miles-credit

Top Issue Authors

  • djgagne (20)
  • charlie-becker (17)
  • kafitzgerald (10)
  • dkimpara (8)
  • jsschreck (6)
  • yingkaisha (4)
  • kevinyang-cky (4)
  • kjmayer (3)
  • danineamati (3)
  • NihanthCW (2)
  • sethmcg (2)
  • sgpearse (1)
  • WillyChap (1)
  • ILoveSorasakiHina (1)
  • AidanJanney (1)

Top Pull Request Authors

  • jsschreck (77)
  • djgagne (42)
  • yingkaisha (33)
  • dkimpara (18)
  • charlie-becker (16)
  • WillyChap (14)
  • kanz76 (11)
  • kafitzgerald (9)
  • dependabot[bot] (6)
  • kevinyang-cky (5)
  • sethmcg (5)
  • stanleyakor1 (4)
  • sgpearse (3)
  • NihanthCW (3)
  • pre-commit-ci[bot] (3)

Top Issue Labels

  • enhancement (18)
  • bug (14)
  • documentation (5)
  • help wanted (3)
  • cleanup (3)
  • github_actions (1)
  • question (1)
  • dependencies (1)

Top Pull Request Labels

  • enhancement (11)
  • dependencies (7)
  • github_actions (6)
  • bug (5)
  • cleanup (3)
  • documentation (2)

Package metadata

proxy.golang.org: github.com/ncar/miles-credit

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/ncar/miles-credit#section-documentation
  • Licenses: apache-2.0
  • Latest release: v2026.2.0+incompatible (published 6 days ago)
  • Last Synced: 2026-08-19T20:32:06.199Z (1 day ago)
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/NCAR/miles-credit

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/NCAR/miles-credit#section-documentation
  • Licenses: apache-2.0
  • Latest release: v2026.2.0+incompatible (published 6 days ago)
  • Last Synced: 2026-08-19T20:36:41.378Z (1 day ago)
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%

Dependencies

.github/workflows/ci-cirrus.yml actions
  • actions/checkout 3d3c42e5aac5ba805825da76410c181273ba90b1 composite
tests/CI_CIRRUS/Dockerfile docker
  • nvidia/cuda 12.9.1-base-ubuntu24.04 build
.github/workflows/pr-review-checklist.yml actions
.github/workflows/ci.yml actions
  • actions/checkout 3d3c42e5aac5ba805825da76410c181273ba90b1 composite
  • actions/setup-python 5fda3b95a4ea91299a34e894583c3862153e4b97 composite
  • codecov/codecov-action fb8b3582c8e4def4969c97caa2f19720cb33a72f composite
.github/workflows/pypi.yml actions
  • actions/checkout 3d3c42e5aac5ba805825da76410c181273ba90b1 composite
  • actions/download-artifact 3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c composite
  • actions/setup-python 5fda3b95a4ea91299a34e894583c3862153e4b97 composite
  • actions/upload-artifact 043fb46d1a93c77aae656e7c1c64a875d1fc6a0a composite
  • pypa/gh-action-pypi-publish ba38be9e461d3875417946c167d0b5f3d385a247 composite
pyproject.toml pypi
  • bridgescaler *
  • cartopy *
  • dask *
  • dask-jobqueue *
  • distributed *
  • echo-opt *
  • einops *
  • fsspec *
  • gcsfs *
  • haversine *
  • matplotlib *
  • myst_parser *
  • netcdf4 *
  • numpy *
  • pandas *
  • pre-commit *
  • pvlib *
  • pyarrow *
  • pysteps *
  • pytest *
  • pyyaml *
  • ruff *
  • scikit-learn *
  • segmentation-models-pytorch *
  • sphinx *
  • sphinx-autoapi *
  • sphinx-book-theme *
  • torch *
  • torch-harmonics *
  • torch_geometric *
  • torchvision *
  • xarray *
  • zarr *
requirements.txt pypi
  • bridgescaler *
  • cartopy *
  • dask *
  • dask-jobqueue *
  • distributed *
  • echo-opt *
  • einops *
  • fsspec *
  • gcsfs *
  • haversine *
  • jupyter *
  • matplotlib *
  • netcdf4 *
  • numpy *
  • pandas *
  • pre-commit *
  • pvlib *
  • pyarrow *
  • pytest *
  • pyyaml *
  • ruff *
  • scikit-learn *
  • segmentation-models-pytorch *
  • torch *
  • torch-harmonics *
  • torch_geometric *
  • torchvision *
  • xarray *
  • zarr *
setup.py pypi

Score: -Infinity