Back to packageRELEASE DETAILS

0.1.0

PyPI

aiclimate

A CLI tool that scaffolds Python ML/data science projects for AI in climate and environmental sciences research.

Published25 Feb 2026

Direct dependencies8

Transitive dependenciesNot calculated

README

Version 0.1.0 documentation

aiclimate

A CLI tool that scaffolds Python ML/data science projects for AI in climate and environmental sciences research.

Built by AI for Climate and Environmental Sciences.

Quick Start

# Install with uv
uv tool install aiclimate

# Scaffold a new project (interactive)
aiclimate

# Or use with an external cookiecutter template
aiclimate gh:user/template

What You Get

When you run aiclimate, you'll be prompted for project details and then a complete project is scaffolded:

my-climate-ai-project/
├── pyproject.toml          # uv-compatible, with ML + climate deps
├── justfile                # Task runner recipes
├── .python-version
├── .gitignore
├── README.md
├── .github/workflows/ci.yml
├── configs/
│   └── default.yaml        # Experiment configuration
├── data/
│   ├── raw/                # Original, immutable data
│   ├── processed/          # Cleaned and transformed data
│   └── external/           # Third-party data sources
├── experiments/            # Experiment outputs and logs
├── models/                 # Trained model checkpoints
├── notebooks/
│   └── 01_exploration.ipynb
├── src/<package_name>/
│   ├── __init__.py
│   ├── config.py           # Configuration loading
│   ├── train.py            # Training entrypoint
│   ├── evaluate.py         # Evaluation entrypoint
│   └── predict.py          # Inference entrypoint
└── tests/
    └── test_placeholder.py

Template Variables

Variable	Description	Default
`project_name`	Human-readable project name	My Climate AI Project
`project_slug`	Directory name (auto-generated)	my-climate-ai-project
`package_name`	Python package name (auto-generated)	my_climate_ai_project
`project_description`	Short project description	...
`author_name`	Your name	Your Name
`author_email`	Your email	...
`python_version`	Python version	3.12
`ml_framework`	ML framework (pytorch/tensorflow/jax/none)	pytorch
`include_dvc`	Include DVC for data versioning	no
`license`	License type	MIT

Default Dependencies

Projects come pre-configured with common climate/environmental AI packages:

Data: numpy, pandas, xarray, netCDF4, scipy
ML: scikit-learn + your choice of pytorch/tensorflow/jax
Visualization: matplotlib, seaborn
Utilities: pyyaml, tqdm, loguru
Dev tools: pytest, ruff, jupyter

Backward Compatibility

aiclimate is built on the cookiecutter engine and can use any existing cookiecutter template:

aiclimate gh:audreyfeldroy/cookiecutter-pypackage

Development

# Clone and install
git clone https://github.com/aiclimate/aiclimate.git
cd aiclimate
uv sync

# Run tests
just test-all

# Lint
just lint-check

License

BSD-3-Clause

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 8

Native requirements

8 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
binaryornot Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`binaryornot>=0.4.4`	runtime
Jinja2 Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`Jinja2<4.0.0,>=2.7`	runtime
click Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`click<9.0.0,>=7.0`	runtime
pyyaml Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`pyyaml>=5.3.1`	runtime
python-slugify Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`python-slugify>=4.0.0`	runtime
requests Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`requests>=2.23.0`	runtime
arrow Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`arrow`	runtime
rich Environment { "extras": "", "marker": null, "requires_python": ">=3.10", "evaluation": "NOT_EVALUATED" }	`rich`	runtime