SAF | Technology RadarSAF | Technology Radar
Trial

UV is an extremely fast Python package and project manager written in Rust, developed by Astral (creators of Ruff). UV moves from hold to trial: work is ongoing to replace Poetry with UV across SAF.

Why UV

  • 10-100x faster: Orders of magnitude faster than pip and Poetry for dependency resolution and installation.
  • Unified tool: A single tool for package management, virtual environments, and Python version management.
  • Standards-based: Uses the standard [project] table of pyproject.toml and a cross-platform uv.lock lockfile.

Current status: Trial

  • The SAF monorepo is managed with UV (uv.lock), and its tasks run through Moon with uv run.
  • Lockfiles are checked in CI, and Dependabot keeps UV-managed dependencies up to date.
  • Some parts of SAF still rely on Poetry, such as example solutions and solution workflows driven by the SAF CLI. They are being migrated.

History

In summer 2025, a first attempt to replace Poetry with UV in the SAF Desktop Installer was aborted because of compatibility issues between UV and PyInstaller, and UV was put on hold.

Recommendation

Use UV for new Python projects and packages in the SAF repository. UV moves to adopt once the migration from Poetry is complete.

Hold

UV is an extremely fast Python package and project manager written in Rust, developed by Astral (creators of Ruff). While highly promising for its exceptional performance, UV is currently on hold in SAF due to compatibility issues encountered during migration efforts.

Performance Promise

UV offers significant advantages that make it attractive for SAF:

  • 10-100x Faster: Orders of magnitude faster than pip and Poetry for dependency resolution and installation
  • Unified Tool: Single tool for package management, virtual environments, and Python version management
  • Rust-Powered: Built in Rust for maximum performance and reliability
  • pip-Compatible: Drop-in replacement for pip with familiar commands

Migration Attempt: Summer 2025

During summer 2025, the SAF team attempted to replace Poetry with UV in the SAF Desktop Installer:

  • Goal: Leverage UV's performance benefits to speed up installer build times
  • Blocker: Multiple compatibility issues and conflicts between UV and PyInstaller emerged
  • Status: Migration effort was aborted due to these technical challenges

Current Status: Hold

UV remains on hold while Poetry continues as the standard dependency management tool for SAF projects. The hold status reflects:

  • Recognition of UV's potential but acknowledgment of current incompatibilities
  • Need for ecosystem maturity and better PyInstaller integration

Mid-Term Vision

Despite the current hold, the long-term strategy is to replace Poetry with UV across all SAF components once:

  • PyInstaller compatibility issues are resolved (either by UV, PyInstaller, or the SAF team)
  • UV reaches sufficient maturity for production use in complex packaging scenarios