Setting up a python environment with uv

Step 1: Install uv

If you haven’t installed uv, install it following the official instructions

Step 2: Create a new project

Open your preferred terminal and run:

uv init --python

Step 3: install hysom

uv add hysom

Your environment is now set up and ready to use. However, you might want to install additional libraries:`

(optional) Step 4: Install IPykernel and other libraries

If you want to use jupyter notebooks (or notebooks within vscode), you also want to install the IPykernel:

uv add --dev ipykernel

Also, if you haven’t done it already, install pandas. It is not required for HySOM but you’ll likely need it, especially if you want to replicate the tutorials in this documentation:

pip install pandas

Your virtual environment is now ready to use!