Installation

Prerequisites

• Git — Download and install Git, then enable LFS:

  git lfs install

• VPN — Connect to your VPN (required to reach external package registries and the recipe server).

• uv — Install uv.

Steps

Step 1. Download the latest OV Hub .whl from the ov-pro-tools releases page (or request the file from a member of Overview.ai), then install it:

uv tool install --force ./ov_hub-<version>-py3-none-any.whl

Step 2. Verify the installation:

ov-hub doctor

It's normal for some checks to fail at this point — authentication hasn't been configured yet and will be completed in a later step.

Step 3. Start the OV Hub server. Choose based on your role:

• View and sync recipes only:

  ov-hub serve

• Publish new recipe versions to the team:

  ov-hub serve --allow-publish-new-version

Step 4. Open http://localhost:8080/ and go to the Settings page. Set your Name and Email. For the SSH Key, use the one provided by your team lead or request it from a member of Overview.ai.

Step 5. Create a local folder to use as the root directory for your recipe repositories. In Settings, enter its path in the Default Clone Directory field.

Keep the terminal open

OV Hub must stay running while you work — including during background uploads and downloads. Do not close the terminal running the server.