Prerequisites: have uv installed on your computer.

1. Download the wheels ZIP file from here: https://github.com/venice-v5/venice/actions/runs/20021367896. Unzip it and copy the venice-0.1.0-py3-none-any.whl file into an empty directory; this directory will be your project directory, so choose wisely!
2. Download the appropriate wheels ZIP file from here: https://github.com/venice-v5/venice-cli/actions/runs/20020757475, based on your computer. For example, if you have an Apple Silicon (ARM) Mac, download wheels-macos-aarch64. If you can't find an artifact that matches your computer, download the wheels-sdist file.

Note

sdist wheels will download the full CLI codebase onto your computer and build it, which is much much slower than using the perfectly matching wheel for your computer (which contains a prebuilt binary tailored to your machine.)

Unzip it and copy the venice_cli-0.1.0-cp314-cp314-<target>.whl to your project directory. The <target> will differ depending on which ZIP file you downloaded!

Note

The cp314 part of the file name means that this wheel is built for Python 3.14. When we set up our project in the next step, note that we configure the project to also use Python 3.14; package manager resolves will error if these versions do not match

3. Initialize a new project using Python 3.14: uv init -p 3.14.
4. Add your dependencies:

uv add ./venice-0.1.0-py3-none-any.whl
# fill this in with your actual venice_cli wheel path!
uv add --dev ./venice_cli-0.1.0-cp314-cp314-<target>.whl

5. You're all set up! Try building your project:

uv run venice-cli build

This will also prompt you to select a slot to use for future uploads. You can always change this slot in your project's pyproject.toml config.

The run command builds and uploads your project, then runs it while opening the terminal:

uv run venice-cli run

Venice is also end-to-end typesafe, giving you best-in-class editor support:

It also integrates with type checkers such as Pyright: