Skip to content

Create automatic uv installation script#4710

Open
mattiagaggi wants to merge 2 commits intofacebookresearch:mainfrom
mattiagaggi:mark-uv-install-experimental
Open

Create automatic uv installation script#4710
mattiagaggi wants to merge 2 commits intofacebookresearch:mainfrom
mattiagaggi:mark-uv-install-experimental

Conversation

@mattiagaggi
Copy link

@mattiagaggi mattiagaggi commented Dec 4, 2025

Create UV pip installation script

Fixes ##4510

Summary

This PR marks the UV-based installation method as experimental and improves the documentation to clarify that it should not be the primary installation method. The changes ensure users understand that conda packages or manual builds are recommended for production use.

Changes

Documentation Updates

  1. INSTALL.md:

    • Added experimental warning to the UV installation section
  2. install_with_uv.sh:
    file to automatically install uv

    • Updated GPU detection messages to clearly state "GPU automatically detected"
    • Messaging for CUDA and ROCm detection

Testing

The installation script has been tested on:

  • Linux x86_64 (Ubuntu 22.04, Debian Bookworm)
  • Linux ARM64 (Ubuntu 22.04)
  • macOS (Intel and Apple Silicon)

All tests were performed with CPU-only builds.

Checklist

  • Documentation updated
  • Script messaging improved
  • Prerequisites clearly documented
  • Experimental status clearly marked
  • Tested platforms documented

- Add experimental warning to UV installation section in INSTALL.md
- Update install_with_uv.sh to clearly indicate GPU auto-detection
- Document tested platforms (CPU-only)
- Remove --jobs option from documentation (auto-detected by default)
@meta-cla meta-cla bot added the CLA Signed label Dec 4, 2025
@mattiagaggi mattiagaggi changed the title Mark UV installation as experimental Create automatic uv installation script Dec 4, 2025
@mnorris11
Copy link

To be looked at after PyPI package support.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants