Skip to main content

ClimAID — Climate change impact using AI on Diseases

Version 0.4.0 (beta, under active testing) · Documentation · PyPI · Changelog · Paper

ClimAID is an integrated toolkit for modelling, forecasting and projecting climate-sensitive diseases such as dengue and malaria, using machine learning, a climate-informed transmission model and CMIP6 climate-model ensembles.

  • Built-in climate data for South Asia: India, Nepal, Bhutan, Sri Lanka, Myanmar, Afghanistan, Pakistan and Bangladesh.
  • Data from other countries are supported through the global mode of the browser interface.

Under active testing. ClimAID 0.4.0 has been checked on synthetic data with a known answer, but not yet validated on real surveillance data or real CMIP6 projections. Treat outputs as research estimates and do not use them as the sole basis for public-health decisions. See Status & validation.


What's new in 0.4.0

0.4.0 is the first public release of ClimAID v2; the previous public release was 0.1.2 (v1 only).

  • ClimAID v2 (additive): probabilistic forecasts with calibrated likely ranges, a climate-informed renewal (transmission) model, a seasonal-naive benchmark, 21 models with compulsory leakage-safe tuning, rolling backtests ("hindcasts"), and a hybrid near-term + CMIP6 scenario outlook (DiseaseModel.project_v2()).
  • Plain-language reports with a Good / Moderate / Low trust rating; technical details kept in a collapsible section.
  • Leakage fixes in v1 (annual-average climate feature, test-set reuse during lag optimisation, projection features that did not match training). v1 metrics from 0.1.x were optimistic; rerun before citing them.
  • Dashboard with separate v2 (default) and v1 pages; documentation bundled offline (climaid docs).

Full list, including every change that alters results: CHANGELOG.md.


Installation

pip install climaid              # core
pip install "climaid[ml]"        # + XGBoost, LightGBM, CatBoost

Requires Python 3.10 or newer. For development: pip install -e ".[test]" from a clone of this repository.

Optional local-LLM reports: install Ollama and run ollama serve. No extra Python package is needed; without it, ClimAID uses its built-in deterministic C-DSI reports.


Two pipelines

ClimAID v2 (recommended) ClimAID v1 (legacy)
Purpose Forecasts for the coming months, and climate-scenario outlooks to 2050–2100 Lag-optimised point predictions and CMIP6 projections
Output Expected cases with likely ranges Expected cases
Models 21, including a climate transmission model and v1's stacked model Stacked base → residual → correction models
Checked by Held-out months, rolling backtests, calibrated ranges One test year
Report Plain-language summary + technical details C-DSI deterministic report

Quick examples

from climaid.climaid_model import DiseaseModel

dm = DiseaseModel(district="IND_Pune_MAHARASHTRA", disease_file="dengue.xlsx", disease_name="Dengue")

# v2: probabilistic forecast for the next 12 months
result = dm.forecast_v2(forecast_origin="2023-12-31", horizon=12, tuning="balanced", save_report=True)
print(result["report_path"])

# v2: climate-scenario outlook
outlook = dm.project_v2(end_year=2050, ssps=["ssp245", "ssp585"])
print(outlook["decades"])

# v1 (legacy)
dm.optimize_lags()
dm.train_final_model()

Lower-level v2 engine and migration notes: MIGRATION_v2.md.


Interfaces

climaid browse    # browser dashboard (South Asian and global data); v2 and v1 pages
climaid wizard    # terminal wizard (South Asian data); choose v1, v2 or both
climaid docs      # open the documentation bundled with this installation (offline)
climaid --version

Documentation and project files

Where What
sam-as.github.io/ClimAID User guide, API reference, status & validation, changelog
CHANGELOG.md All changes, by version
MIGRATION_v2.md Moving from v1 to v2
V2_FEEDBACK_RESPONSE.md Reviewer concerns and how v2 addresses them
benchmarks/ Synthetic datasets, benchmark runner and saved results
README_DOCS.md Building and releasing the documentation

Designed for

Epidemiologists, climate scientists, public-health analysts and data scientists.

Citation

Sam, A.K., Phuleria, H.C. (2026). ClimAID: An AI-integrated Global Hybrid Climate-Disease Modelling Framework. Preprint: https://doi.org/10.21203/rs.3.rs-9394047/v1

License

MIT. Designed by Avik Kumar Sam & Harish C. Phuleria as open-access software through the National Disease Modelling Consortium.

Metadata

Release files for climaid 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for climaid 0.4.0
File Size Uploaded Provenance Actions
climaid-0.4.0.tar.gz 11.9 MB With provenance Details for climaid-0.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for climaid 0.4.0
File Interpreter ABI Platform Actions
climaid-0.4.0-py3-none-any.whl Python 3 none any Details for climaid-0.4.0-py3-none-any.whl

Total release size: 24.3 MB

Release files / climaid-0.4.0.tar.gz

Download URL climaid-0.4.0.tar.gz
Size 11.9 MB
Tags Source
SHA-256 checksum
How to use checksums
57cba1e116129740d50588efdb0f54f4a95ce029065c3e1ef5b31045870c9b5c
BLAKE2b-256 checksum
How to use checksums
f042bc42747e57bbbab89cf7beb3b79df44e31f177683aead7162f37958af103
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

Release files / climaid-0.4.0-py3-none-any.whl

Download URL climaid-0.4.0-py3-none-any.whl
Size 12.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9011b26fe2e2aa94d90d879579e3cf3ee18b39b44638cc5744b9adec1e788016
BLAKE2b-256 checksum
How to use checksums
5ac5ce02e9a57505126cd0c766add12d02726004a42fa087bed649dbefcbeb65
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

Security for climaid 0.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for climaid-0.4.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page