Bootstrap patched TLS dependencies and fix the prep quickstart install

#1
by m1c0l - opened
Files changed (1) hide show
  1. README.md +28 -4
README.md CHANGED
@@ -54,15 +54,39 @@ This repository is the [Diffusers](https://github.com/huggingface/diffusers) rel
54
 
55
  ## Quickstart
56
 
 
 
 
 
 
 
 
 
57
  ```bash
 
 
 
 
58
  # RFD4-Proteina was merged into Diffusers on 2026-10-20 and ships in the next release.
59
  # Until that release, install Diffusers from git:
60
- pip install git+https://github.com/huggingface/diffusers git+https://huggingface.co/nvidia/RFD4-Proteina-prep@c9959efdebd75ac7fe9129fbbf0e291a6e0487d5 accelerate
61
-
62
- # Once the release is out, this is enough:
63
- # pip install diffusers git+https://huggingface.co/nvidia/RFD4-Proteina-prep@c9959efdebd75ac7fe9129fbbf0e291a6e0487d5
 
 
 
 
 
64
  ```
65
 
 
 
 
 
 
 
 
66
  ```python
67
  import torch
68
  from huggingface_hub import hf_hub_download
 
54
 
55
  ## Quickstart
56
 
57
+ Before running the commands below, update the operating system's CA certificates and Git's
58
+ TLS trust store using the [platform-specific incident guidance](https://emudhra.we-have-a-problem.com/).
59
+ Git-based installs use Git's TLS configuration, independently of Python's `certifi`.
60
+ Run the bootstrap in the Python environment you will use, including each newly created virtual
61
+ environment. The hash-pinned pip upgrade follows the
62
+ [Python security advisory](https://discuss.python.org/t/109576); updating `certifi` alone does not
63
+ update pip's bundled certificates.
64
+
65
  ```bash
66
+ # Bootstrap pip's bundled CA certificates before installing dependencies.
67
+ python -m pip install "pip @ https://files.pythonhosted.org/packages/3f/06/3e4420302363fbb71be3c7f35ce042f54bfca330e3e66b3a2e3c4cca579f/pip-26.2.2-py3-none-any.whl#sha256=fd7f4dfa8190e014013b9f08f3e973f4e4c26ffd179a204895533a7254813a70"
68
+ python -m pip install --upgrade "certifi>=2026.10.19"
69
+
70
  # RFD4-Proteina was merged into Diffusers on 2026-10-20 and ships in the next release.
71
  # Until that release, install Diffusers from git:
72
+ python -m pip install huggingface_hub
73
+ hf download nvidia/RFD4-Proteina-prep \
74
+ --revision c9959efdebd75ac7fe9129fbbf0e291a6e0487d5 \
75
+ --local-dir rfd4-prep
76
+ python -m pip install ./rfd4-prep
77
+ python -m pip install git+https://github.com/huggingface/diffusers accelerate
78
+
79
+ # Once the release is out, replace the final command above with:
80
+ # python -m pip install diffusers accelerate
81
  ```
82
 
83
+ If using alternative installers, use `uv>=0.13.4` or `pixi>=0.82.1` before downloads.
84
+ These repositories do not build Rust or Node tooling. Native download extensions such as
85
+ `hf-xet`, if installed through `huggingface_hub`, have their own TLS implementation: a
86
+ `certifi` upgrade does not establish that those binaries are patched. Check the upstream
87
+ binary's advisory or build provenance separately; updating a local Rust compiler does not
88
+ rebuild installed wheels. Keep TLS verification enabled.
89
+
90
  ```python
91
  import torch
92
  from huggingface_hub import hf_hub_download