RFC: Change package managament to UV

[cjdsellers]

This RFC proposes changing the package and dependency management tooling for NautilusTrader from Poetry to UV.

Pros

• Performance (dependency resolution, env setup, package installation, etc)
• Improved/simplified environment setup
• Improved/simplified python version management (could also replace the recommended pyenv for this?)
• Potentially better design principles than Poetry - less issues, more longevity?
• Gaining community adoption fast

Cons

I'm not currently aware of any disadvantages of using UV over Poetry?

Questions

• Is there anything which Poetry can do right now which UV can't, specific to NautilusTrader?
• Does anyone have any hesitations about making this change soon?
• Does anyone have suggestions for alternatives? (e.g., pixi already suggested and is conda specific)

[sunlei]

In our project, we have experimented with the following setups:

• asdf + poetry
• asdf + pdm
• mise + poetry
• mise + pdm

We ultimately settled on: mise + poetry.

The switch from asdf to mise brought significant benefits.
The transition from poetry to pdm was not made due to the large number of projects involved; however, pdm has been adopted in some personal projects.

I’ve been keeping an eye on uv, but haven’t yet invested time to explore it in detail.

[davidsblom]

Very welcome change. One thing I like is that when nautilus is added as a dependency to another project with git via uv, it doesn't fetch the complete git history unlike poetry.

[faysou]

uv is not supported yet by intellijidea, but should be soon https://youtrack.jetbrains.com/issue/PY-70533/Support-package-management-via-uv

uv presentation for reference https://youtu.be/gSKTfG1GXYQ

[omencat]

Glad to see some uv converts. I am by no means a uv expert, but here is my uv pyproject.toml that works with nautilus_trader that might be of help kick starting this effort.

[project]
name = "nautilus_trader"
version = "0.1.0"
description = "Your best friend, out of the box!"
readme = "README.md"
requires-python = ">=3.12"
dependencies = [
    "cython==3.1.0a1",
    "msgspec>=0.19.0,<0.20.0",
    "nautilus-trader[dydx]==1.211.0a20250112",
    "numba>=0.60.0",
    "scikit-learn>=1.5.2",
]
[[tool.uv.index]]
name = "nautilus-trader"
url = "https://packages.nautechsystems.io/simple"
# [tool.uv.sources]
# nautilus-trader = { git = "https://github.com/nautechsystems/nautilus_trader.git", branch = "develop" } #rev = "19a599619b110fc7087f9f3baf58dd7916bb2ffe" }
[build-system]
requires = ["setuptools>=75.6.0", "wheel", "setuptools-rust>=1.10.2"]
build-backend = "setuptools.build_meta"

[dependency-groups]
dev = [
    "ipykernel>=6.29.5",
    "matplotlib>=3.10.0",
]

I'm still learning it myself. after updates I run: uv lock --upgrade;uv sync