PyPI

CREDIT npj Climate and Atmospheric Science Article

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.

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:

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.

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 for the CREDIT 6-hour WXFormer and FuXi models and the 1-hour WXFormer are available on huggingface.

• 6-Hour WXFormer
• 1-Hour WXFormer
• 6-Hour FuXi

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.

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.