3.x | uvx is now uvenv

3.x | uvx is now uvenv

As of July 8th, 2024, the uvx project has been renamed and transitioned to uvenv. This post serves as a formal deprecation notice for this current repository.

Why the Change?

Astral's uv project recently introduced its own uvx command (uv tool run), leading to naming conflicts. To avoid confusion, we've renamed our tool to uvenv (uv + venv) starting with version 3.0.

This repository is now deprecated and will no longer receive updates or new features. Versions prior to 2.x will remain available for historical purposes, but active development has fully shifted to uvenv.

Key Improvements in uvenv 3.0

• Improved Error Context: With enhanced error handling powered by anyhow, diagnosing issues is now simpler and more intuitive.
• Seamless Migration Tools: Easily migrate your existing environments and settings to uvenv using the new uvenv self migrate command.

Getting Started with uvenv

To transition from uvx to uvenv, follow these steps:

Upgrade:

# Automatically:
uvx self-update # if you have uvx 2.4 or older
uvx self update  # If you have uvx 2.5 or newer, this will install `uvenv` and uninstall `uvx`.

# Manually:
pip uninstall uvx
pip install uvenv

Migrate:

uvenv self migrate

This command will transfer your existing environments and commands to uvenv. If you encounter issues like Directory not empty, ensure that ~/.local/uvenv does not already exist.

What's Next?

Check out the uvenv repository for more details, documentation and the latest changelogs.

🦀 uvx 2.0

Introducing uvx 2.0: Enhanced Performance with Rust

The release of uvx 2.0 marks a significant upgrade, leveraging the power of Rust to deliver vastly improved performance and compatibility with the uv toolchain. This new version is supported for Linux platforms on x86_64 (amd64) and aarch64 (ARM64) architectures.

Key Highlights:

• Rust-Powered Performance: Faster start-up times and more efficient operation enhance the overall user experience.
• Optimized for Linux: Prebuilt binaries are available for Linux on 64 bit platforms, ensuring fast installation and usage.

Platform Support:

• Manual Compilation: For users on platforms where prebuilt binaries are not available, uvx 2.0 can still be manually compiled from source. This approach ensures that users on unsupported architectures can access the latest version.
• Pip Installation Safety: To ensure a smooth user experience and avoid the potential for slow, unintentional Rust compilations, installing uvx 2.0 via pip on unsupported platforms will not trigger a build process. Instead, the installation will halt early, enabling users to manually compile only if desired.
• Self-Update Functionality: The self-update mechanism will not attempt to update to version 2.x on unsupported platforms. This ensures compatibility and stability for all users.

Where to Find uvx 2.0:

• Discover more about uvx 2.0 and access the source for manual compilation at robinvandernoord/uvx2.

For further details and to see the full list of improvements, please refer to the changelog at CHANGELOG.md on GitHub.