Build Process

This page describes how to set the package version and build a wheel for Earth2Studio from a local clone. It is intended for contributors and maintainers.

Prerequisites: uv installed, a clone of the repository, and a synced development environment (for example, uv sync as described in the Developer Overview). Run all commands below from the repository root (the directory that contains pyproject.toml).

Setting the Version

To check the version of the current package:

uv run hatch version

To bump the version automatically, use the following hatch commands:

# To bump to next pre-release
uv run hatch version minor,a

# To bump to release candidate version
uv run hatch version rc

# To bump to final release version
uv run hatch version release

Building a Wheel

To build the wheel, use the uv build command:

uv build