Installation¶

harvest-forecast-py is a pure-Python library with three runtime dependencies. It runs on Python 3.12+ and works with any modern project setup.

Requirements¶

Python 3.12+ required

harvest-forecast-py requires Python 3.12 or newer. It uses modern type syntax such as str | None and list[str] that is only fully supported on 3.12+. It is tested on Python 3.12, 3.13, and 3.14.

The library has three runtime dependencies:

Dependency	Purpose
httpx `>=0.28`	HTTP client (async and sync)
pydantic `>=2.0`	Response model validation
tenacity `>=9.0`	Retry logic with backoff

Installing with pip¶

Install from PyPI using pip:

pip install harvest-forecast-py

Installing with uv¶

If you use uv for dependency management:

uv add harvest-forecast-py

Verifying the installation¶

Confirm the package is installed and check the version:

python -c "import harvest_forecast; print(harvest_forecast.__version__)"

You should see the installed version printed, for example:

0.1.0

Troubleshooting

If you see ModuleNotFoundError: No module named 'harvest_forecast', make sure the virtual environment where you installed the package is the same one you are running Python from. Activate the environment (or use uv run) and try again.

Next steps¶

Now that harvest-forecast-py is installed, learn how to authenticate and list resources in minutes:

Quick Start