Hub documentation

Sử dụng Xet Storage

Hub

API docs

Join the Hugging Face community

and get access to the augmented documentation experience

Collaborate on models, datasets and Spaces

Faster examples with accelerated inference

Switch between documentation themes

to get started

Sử dụng Xet Storage

Python

Để truy cập phiên bản nhận biết Xet của huggingface_hub, chỉ cần cài đặt phiên bản mới nhất:

pip install -U huggingface_hub

Từ huggingface_hub 0.32.0, điều này cũng sẽ cài đặt hf_xet. Gói hf_xet tích hợp huggingface_hub với xet-core, client Rust cho backend Xet.

Nếu bạn sử dụng thư viện transformers hoặc datasets, chúng đã đang sử dụng huggingface_hub. Miễn là phiên bản của huggingface_hub >= 0.32.0, bạn không cần thực hiện thêm thao tác nào.

Khi các phiên bản huggingface_hub >= 0.30.0 và < 0.32.0 được cài đặt, hf_xet phải được cài đặt một cách rõ ràng:

pip install -U hf-xet

Và như vậy là xong! Bạn giờ đã tận dụng được lợi ích của việc khử trùng lặp Xet cho cả thao tác tải lên và tải xuống. Các thành viên nhóm sử dụng phiên bản huggingface_hub < 0.30.0 vẫn có thể tải lên và tải xuống các kho thông qua tính tương thích ngược do cầu nối LFS cung cấp.

Để xem tài liệu sử dụng chi tiết hơn, hãy tham khảo tài liệu của huggingface_hub cho:

Git

Người dùng Git có thể tận dụng các lợi ích của Xet bằng cách tải xuống và cài đặt tiện ích mở rộng Git Xet. Sau khi cài đặt, chỉ cần sử dụng các quy trình chuẩn để quản lý kho Hub bằng Git - không cần thay đổi gì thêm.

Yêu cầu tiên quyết

Cài đặt Git và Git LFS.

Cài đặt trên macOS hoặc Linux (amd64 hoặc aarch64)

Cài đặt bằng một script cài đặt với lệnh sau trong terminal của bạn (yêu cầu curl và unzip):

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/huggingface/xet-core/refs/heads/main/git_xet/install.sh | sh

Hoặc, cài đặt bằng Homebrew:

brew install git-xet
git xet install

Để xác minh cài đặt, hãy chạy:

git xet --version

Windows (amd64)

Sử dụng winget:

winget install git-xet

Sử dụng trình cài đặt:

Tải xuống git-xet-windows-installer-x86_64.zip (khả dụng tại đây) và giải nén.
Chạy tệp cài đặt msi và làm theo các hướng dẫn.

Cài đặt thủ công:

Tải xuống git-xet-windows-x86_64.zip (khả dụng tại đây) và giải nén.
Đặt git-xet.exe đã trích xuất vào một thư mục PATH.
Chạy git xet install trong terminal.

Để xác minh cài đặt, hãy chạy:

git xet --version

Sử dụng Git Xet

Sau khi cài đặt trên nền tảng của bạn, việc sử dụng Git Xet đơn giản như việc làm theo các quy trình Git chuẩn của Hub.

Hãy đảm bảo rằng tất cả các điều kiện tiên quyết đã được cài đặt và cấu hình, làm theo các hướng dẫn thiết lập để làm việc với các kho trên Hub, sau đó cam kết các thay đổi của bạn và push lên Hub:

# Create any files you like! Then...
git add .
git commit -m "Uploading new models"  # You can choose any descriptive message
git push

Bên trong, giao thức Xet được gọi để tải các tệp lớn lên bộ nhớ Xet, tăng tốc độ tải lên nhờ sức mạnh của loại bỏ trùng lặp ở cấp độ chunk.

Gỡ cài đặt trên macOS hoặc Linux

Sử dụng Homebrew:

git xet uninstall
brew uninstall git-xet

Nếu bạn đã sử dụng script cài đặt (cho MacOS hoặc Linux), hãy chạy lệnh sau trong terminal của bạn:

git xet uninstall
sudo rm $(which git-xet)

Gỡ cài đặt trên Windows

Nếu bạn đã sử dụng winget:

winget uninstall git-xet

Nếu bạn đã sử dụng trình cài đặt:

Điều hướng đến Settings -> Apps -> Installed apps
Tìm “Git-Xet”.
Chọn tùy chọn “Uninstall” có trong menu ngữ cảnh.

Nếu bạn đã cài đặt thủ công:

Chạy git xet uninstall trong terminal.
Xóa tệp git-xet.exe khỏi vị trí ban đầu của nó.

Khuyến nghị

Xet tích hợp liền mạch với tất cả các luồng công việc của Hub. Tuy nhiên, có một vài bước bạn có thể cân nhắc để tận dụng tối đa lợi ích từ bộ nhớ Xet.

Khi tải lên hoặc tải xuống bằng Python:

Đảm bảo hf_xet đã được cài đặt: Trong khi Xet vẫn tương thích ngược với các client cũ được tối ưu cho Git LFS, việc tích hợp hf_xet với huggingface_hub mang lại hiệu suất tối ưu dựa trên chunk và tốc độ lặp lại nhanh hơn trên các tệp lớn.
Độ song song thích ứng được bật theo mặc định: hf_xet tự động điều chỉnh số lượng luồng truyền song song dựa trên điều kiện mạng thời gian thực — không cần cấu hình. Các cài đặt mặc định sẽ bão hòa hầu hết các đường truyền mạng mà không cần tinh chỉnh.
Các bộ đệm tải xuống được mở rộng theo bộ nhớ hệ thống: Bắt đầu từ hf_xet 1.7.0, kích thước của các bộ đệm tải xuống được xác định dựa trên bộ nhớ khả dụng cho hf_xet, bao gồm cả giới hạn bộ nhớ của container. Các container nhỏ sẽ sử dụng ít bộ nhớ hơn cho việc tải xuống và các máy lớn sẽ sử dụng nhiều hơn, mà không cần phải cấu hình. Xem Các bộ đệm tải xuống.
Điều chỉnh nâng cao: Để kiểm soát chi tiết hơn, HF_XET_FIXED_DOWNLOAD_CONCURRENCY và HF_XET_FIXED_UPLOAD_CONCURRENCY cho phép bạn cố định mức độ song song thành một giá trị cụ thể, bỏ qua bộ điều khiển thích ứng. Xem biến môi trường của hf_xet để biết danh sách đầy đủ các tùy chọn.

Khi tải lên hoặc tải xuống bằng Git hoặc Python:

Tận dụng các commit tăng dần thường xuyên: Việc khử trùng lặp ở mức chunk của Xet cho phép bạn cập nhật tăng dần các mô hình hoặc bộ dữ liệu một cách an toàn. Chỉ các chunk bị thay đổi mới được tải lên, nên các commit thường xuyên vừa nhanh vừa tiết kiệm dung lượng lưu trữ.
Cụ thể trong .gitattributes: Khi định nghĩa các mẫu cho Xet hoặc LFS, hãy sử dụng các phần mở rộng tệp chính xác (ví dụ: *.safetensors, *.bin) để tránh việc định tuyến các tệp nhỏ hơn qua bộ nhớ lưu trữ tệp lớn một cách không cần thiết.
Ưu tiên quyền truy cập của cộng đồng: Xet tăng đáng kể hiệu suất và quy mô của các thao tác chuyển file lớn. Thay vì cấu trúc kho lưu trữ của bạn để giảm tổng kích thước (hoặc kích thước của từng file), hãy tổ chức nó cho các cộng tác viên và người dùng cộng đồng để họ có thể dễ dàng điều hướng và truy xuất nội dung cần thiết.

Tải lên sau proxy hoặc tường lửa

Bắt đầu từ hf_xet 1.8.0, các thao tác tải lên có thể gửi dữ liệu trực tiếp đến Amazon S3 thay vì chỉ thông qua dịch vụ lưu trữ Xet. Hub sẽ quyết định cho từng thao tác tải lên có sử dụng tải lên trực tiếp hay không, và đang bật tính năng này dần dần. Thao tác tải xuống không thay đổi.

Nếu mạng của bạn hạn chế lưu lượng ra bên ngoài, hãy cho phép các tên máy chủ này (HTTPS, cổng 443) bên cạnh các tên máy chủ được liệt kê trong Tải xuống sau proxy hoặc tường lửa:

Hostname	Mục đích
`s3.us-east-1.amazonaws.com`	Tải lên trực tiếp (Hoa Kỳ)
`s3.eu-west-3.amazonaws.com`	Tải lên trực tiếp cho các kho lưu trữ được lưu trữ tại EU

Các tên máy chủ này không thuộc hf.co hoặc huggingface.co, do đó việc cho phép các hậu tố đó không bao phủ chúng.

Nếu hf_xet không thể kết nối tới S3, nó sẽ thử lại việc tải lên trực tiếp và sau đó gửi dữ liệu đó qua dịch vụ lưu trữ Xet. Quá trình tải lên vẫn hoàn tất, nhưng có thể chậm hơn nhiều vì mỗi khối phải chờ qua các lần thử lại trước. Log của hf_xet hiển thị Upload grant URL unreachable, falling back to legacy xorb upload path (may be slower) khi điều này xảy ra. Nếu bạn không thể cho phép các tên máy chủ S3, hãy đặt HF_XET_CLIENT_LEGACY_DIRECT_XORB_UPLOAD=1 để tắt tải lên trực tiếp.

Biến môi trường

Cả hf_xet và Git Xet đều được vận hành bởi xet-core, có thể được cấu hình thông qua các biến môi trường. Các bảng dưới đây liệt kê từng biến để kiểm soát chi tiết. Hầu hết người dùng sẽ không cần thay đổi bất kỳ biến nào trong số này — các giá trị mặc định được điều chỉnh để tự động khai thác tối đa phần lớn các đường truyền mạng.

HF_XET_HIGH_PERFORMANCE=1 là một cờ tiện ích điều chỉnh đồng thời một số cài đặt (giới hạn độ song song, kích thước bộ đệm và giới hạn tệp song song). Cờ này được thiết kế cho các máy có băng thông cao và ổ đĩa nhanh. Bắt đầu từ hf_xet 1.7.0, các kích thước bộ đệm mà cờ này thiết lập được dựa trên bộ nhớ khả dụng cho hf_xet (xem Tải xuống bộ đệm), do đó không còn yêu cầu 64 GB RAM, và bất kỳ biến nào bạn tự thiết lập đều có ưu tiên cao hơn cờ này. Với các phiên bản trước, chỉ nên sử dụng cờ này trên các máy có ít nhất 64 GB RAM.

Chung

Các cờ cấp cao mà hầu hết người dùng thường dùng trước tiên.

Biến môi trường	Mặc định	Mô tả
`HF_XET_HIGH_PERFORMANCE` (biệt danh `HF_XET_HP`)	off	Cờ tiện ích tối đa hóa việc sử dụng mạng và CPU bằng cách tăng đồng thời mức độ song song, kích thước bộ đệm và giới hạn tệp song song. Xem ghi chú ở trên.
`HF_XET_CACHE`	`$HF_HOME/xet`	Thư mục nơi Xet lưu trữ bộ nhớ đệm dữ liệu cục bộ (các chunk đã tải xuống và các shard khử trùng lặp). Có độ ưu tiên cao hơn `HF_HOME`.

Độ song song thích ứng

Mặc định, xet-core sử dụng độ song song thích ứng — điều chỉnh mức độ song song một cách động dựa trên điều kiện mạng thời gian thực. Đây là các cài đặt nâng cao, thường không cần thiết trong hầu hết các trường hợp. Các biến bên dưới kiểm soát hành vi của bộ điều khiển thích ứng:

Biến môi trường	Mặc định	Mô tả
`HF_XET_CLIENT_AC_INITIAL_UPLOAD_CONCURRENCY`	`2`	Số lượng luồng tải đồng thời ban đầu. Chế độ HP: `16`.
`HF_XET_CLIENT_AC_INITIAL_DOWNLOAD_CONCURRENCY`	`4`	Số lượng luồng tải đồng thời ban đầu. Chế độ HP: `16`.
`HF_XET_CLIENT_AC_MIN_UPLOAD_CONCURRENCY`	`1`	Giới hạn dưới cho độ song song tải lên. Chế độ HP: `4`.
`HF_XET_CLIENT_AC_MIN_DOWNLOAD_CONCURRENCY`	`1`	Giới hạn dưới cho độ song song tải xuống. Chế độ HP: `4`.
`HF_XET_CLIENT_AC_MAX_UPLOAD_CONCURRENCY`	`64`	Giới hạn trên cho độ song song tải lên. Chế độ HP: `124`.
`HF_XET_CLIENT_AC_MAX_DOWNLOAD_CONCURRENCY`	`64`	Giới hạn trên cho độ song song tải xuống. Chế độ HP: `124`.
`HF_XET_CLIENT_AC_TARGET_RTT`	`60s`	Thời gian đi và về mục tiêu. Mức độ song song sẽ tăng lên cho đến khi thời gian đi và về dự kiến cho một lần truyền tải hoàn chỉnh vượt quá giá trị này.
`HF_XET_CLIENT_AC_MAX_HEALTHY_RTT`	`90s`	Thời gian đi và về tối đa được chấp nhận. Các lần chuyển tiếp mất nhiều thời gian hơn mức này sẽ được bộ điều khiển thích ứng tính là thất bại.
`HF_XET_CLIENT_AC_HEALTHY_SUCCESS_RATIO_THRESHOLD`	`0.8`	Tỷ lệ thành công mà khi vượt qua ngưỡng này, bộ điều khiển sẽ tăng mức độ đồng thời.
`HF_XET_CLIENT_AC_UNHEALTHY_SUCCESS_RATIO_THRESHOLD`	`0.5`	Tỷ lệ thành công dưới ngưỡng mà bộ điều khiển giảm mức độ đồng thời.
`HF_XET_CLIENT_AC_LOGGING_INTERVAL_MS`	`10000`	Khoảng thời gian (tính bằng mili giây) để ghi log trạng thái đồng thời.

Để cố định mức độ song song thành một giá trị nhất định (bỏ qua bộ điều khiển thích ứng), hãy sử dụng các alias tiện ích HF_XET_FIXED_UPLOAD_CONCURRENCY và HF_XET_FIXED_DOWNLOAD_CONCURRENCY. Các biến này đặt mức độ song song ban đầu, tối thiểu và tối đa cùng bằng một giá trị.

Mạng và Thử lại

Biến môi trường	Mặc định	Mô tả
`HF_XET_CLIENT_RETRY_MAX_ATTEMPTS`	`5`	Số lần thử lại tối đa cho các yêu cầu thất bại.
`HF_XET_CLIENT_RETRY_BASE_DELAY`	`3000ms`	Trễ cơ bản giữa các lần thử lại (với backoff mũ).
`HF_XET_CLIENT_RETRY_MAX_DURATION`	`360s`	Thời gian chờ tối đa trước mỗi lần thử lại đơn lẻ. Việc thử lại sẽ dừng lại sau `HF_XET_CLIENT_RETRY_MAX_ATTEMPTS`, do đó tổng thời gian thử lại có thể vượt quá giá trị này.
`HF_XET_CLIENT_CONNECT_TIMEOUT`	`60s`	Thời gian chờ kết nối TCP.
`HF_XET_CLIENT_READ_TIMEOUT`	`300s`	Thời gian chờ đọc cho các phản hồi HTTP.
`HF_XET_CLIENT_IDLE_CONNECTION_TIMEOUT`	`60s`	Thời gian chờ trước khi các kết nối nhàn rỗi bị đóng.
`HF_XET_CLIENT_MAX_IDLE_CONNECTIONS`	`16`	Số lượng kết nối nhàn rỗi tối đa trong pool.
`HF_XET_CLIENT_RECONSTRUCTION_API_VERSION`	(chưa đặt)	Buộc phiên bản API tải xuống (xây dựng lại) thành `1` hoặc `2`, không có phương án dự phòng. Khi không được đặt, `hf_xet` sẽ thử phiên bản 2 và quay lại phiên bản 1 nếu máy chủ không hỗ trợ.
`HF_XET_CLIENT_SHARD_API_VERSION`	(chưa đặt)	Buộc phiên bản API tải lên (shard) thành `1` hoặc `2`, không có phương án dự phòng. Khi không được đặt, `hf_xet` sẽ thử phiên bản 2 và quay lại phiên bản 1 nếu máy chủ không hỗ trợ.

Chuyển Dữ Liệu

Biến môi trường	Mặc định	Mô tả
`HF_XET_DATA_MAX_CONCURRENT_FILE_INGESTION`	`8`	Số lượng tệp tối đa được xử lý đồng thời trong quá trình tải lên. Chế độ HP: `100`.
`HF_XET_DATA_MAX_CONCURRENT_FILE_DOWNLOADS`	`8`	Số lượng tệp tối đa được tải xuống đồng thời.
`HF_XET_DATA_INGESTION_BLOCK_SIZE`	`8mb`	Kích thước của các khối được đọc trong quá trình nạp tệp.
`HF_XET_DATA_PROGRESS_UPDATE_INTERVAL`	`200ms`	Tần suất cập nhật thanh tiến trình.
`HF_XET_DATA_PROGRESS_UPDATE_SPEED_SAMPLING_WINDOW`	`10s`	Cửa sổ thời gian được sử dụng để tổng hợp các phép đo tốc độ truyền trong báo cáo tiến độ.
`HF_XET_CLIENT_LEGACY_DIRECT_XORB_UPLOAD`	`false`	Đặt thành `1` để gửi tất cả dữ liệu tải lên thông qua dịch vụ lưu trữ Xet thay vì trực tiếp đến S3 (`hf_xet` 1.8.0+). Xem Tải lên sau proxy hoặc tường lửa.

Tải xuống bộ đệm

Các tùy chọn này kiểm soát việc sử dụng bộ nhớ trong quá trình tải xuống.

Bắt đầu từ hf_xet 1.7.0, giá trị mặc định của ba biến DOWNLOAD_BUFFER được xác định dựa trên lượng bộ nhớ mà hf_xet có thể sử dụng. Đây là RAM của máy, hoặc giới hạn bộ nhớ của container nếu giá trị đó thấp hơn. Mỗi giá trị mặc định là một phần của lượng bộ nhớ đó, được giữ trong khoảng từ giá trị tối thiểu đến tối thiểu như trong bảng. Chế độ HP sử dụng gấp đôi phần đó, với cùng giá trị tối thiểu và tối đa. Ví dụ, một container bị giới hạn ở 4 GB sẽ có bộ đệm khoảng 256 MB với giới hạn 1 GB, và một máy có 32 GB sẽ có bộ đệm khoảng 2 GB và giới hạn 8 GB, tương tự các phiên bản trước.

Các phiên bản trước đó, hoặc bất kỳ phiên bản nào không thể xác định được lượng bộ nhớ khả dụng, sẽ sử dụng các giá trị mặc định cố định là 2gb, 512mb và 8gb (trong chế độ HP là 16gb, 2gb và 64gb). Các giá trị đang được sử dụng sẽ được ghi vào tệp nhật ký hf_xet khi nó khởi động (xem Ghi nhật ký).

Biến môi trường	Mặc định	Chế độ HP	Mô tả
`HF_XET_RECONSTRUCTION_MIN_RECONSTRUCTION_FETCH_SIZE`	`256mb`	`1gb`	Kích thước lấy dữ liệu tối thiểu cho các yêu cầu tái tạo.
`HF_XET_RECONSTRUCTION_MAX_RECONSTRUCTION_FETCH_SIZE`	`8gb`	`16gb`	Kích thước lấy dữ liệu tối đa cho các yêu cầu tái tạo.
`HF_XET_RECONSTRUCTION_DOWNLOAD_BUFFER_SIZE`	1/16 bộ nhớ, từ `64mb` đến `16gb`	1/8 bộ nhớ	Ngân sách bộ đệm chia sẻ cơ sở.
`HF_XET_RECONSTRUCTION_DOWNLOAD_BUFFER_PERFILE_SIZE`	1/64 bộ nhớ, từ `16mb` đến `2gb`	1/32 bộ nhớ	Ngân sách bộ đệm bổ sung cho mỗi tệp đang hoạt động.
`HF_XET_RECONSTRUCTION_DOWNLOAD_BUFFER_LIMIT`	1/4 bộ nhớ, từ `264mb` đến `64gb`	1/2 bộ nhớ	Giới hạn cứng cho bộ nhớ đệm tải xuống tổng. Nếu `HF_XET_RECONSTRUCTION_DOWNLOAD_BUFFER_SIZE` được đặt cao hơn mức này, giới hạn sẽ được nâng lên cho khớp.
`HF_XET_DISABLE_MEMORY_DERIVED_DOWNLOAD_BUFFERS`	unset	—	Đặt thành `1` để sử dụng các giá trị mặc định cố định thay vì điều chỉnh kích thước bộ đệm từ bộ nhớ khả dụng.
`HF_XET_RECONSTRUCTION_TARGET_BLOCK_COMPLETION_TIME`	`15m`	—	Thời gian mục tiêu để hoàn thành một khối prefetch. Được sử dụng để xác định lượng dữ liệu cần prefetch trước trong quá trình tải xuống.
`HF_XET_RECONSTRUCTION_MIN_PREFETCH_BUFFER`	`1gb`	—	Lượng dữ liệu tối thiểu cần giữ ở trạng thái đã tải trước trong quá trình tải xuống, bất kể thời gian hoàn thành ước tính.

Bộ đệm phân mảnh

shard cache lưu trữ chỉ mục khử trùng lặp (các “shards” mô tả các khối dữ liệu đã được tải lên trước đó) trên đĩa, trong thư mục cache của Xet. Cache lớn hơn cho phép client khử trùng lặp với nhiều dữ liệu đã thấy trước đó hơn, do đó giảm số byte cần tải lên lại.

Biến môi trường	Mặc định	Mô tả
`HF_XET_SHARD_CACHE_SIZE_LIMIT`	`16gb`	Giới hạn mềm cho bộ đệm shard trên đĩa. Bộ đệm được cắt giảm về kích thước này vào thời điểm bắt đầu một lần chạy, nhưng có thể tăng vượt quá mức đó trong một phiên chạy dài. Theo ước tính, bộ đệm có kích thước X sẽ khử trùng lặp cho khoảng 1000 × X dữ liệu (16 GB → ~16 TB). Tăng giá trị này để cải thiện khử trùng lặp trên các kho dữ liệu rất lớn; giảm nếu bộ đệm đang tăng có nguy cơ làm đầy đĩa. Chấp nhận kích thước đọc được bởi con người (ví dụ: `32gb`) hoặc số byte thô.
`HF_XET_SHARD_CHUNK_INDEX_TABLE_MAX_SIZE`	`67108864`	Số lượng mục chunk tối đa trong chỉ mục khử trùng lặp trong bộ nhớ. Đặt một số nguyên, không phải một kích thước như `128mb`. Bắt đầu từ `hf_xet` 1.7.1, khi chỉ mục đầy, các shard cũ nhất sẽ bị loại bỏ khỏi chỉ mục để nhường chỗ cho các shard mới; các phiên bản trước đó sẽ ngừng thêm chunk khi chỉ mục đầy.
`HF_XET_SHARD_CACHE_SUBDIR`	`shard-cache`	Thư mục con cho bộ đệm shard trong thư mục bộ đệm Xet.

Bộ đệm Chunk

hf_xet không còn sử dụng bộ nhớ đệm chunk cục bộ cho các tệp tải xuống. Các tệp đã tải xuống vẫn được lưu trong bộ nhớ đệm dựa trên tệp của huggingface_hub.

Biến môi trường	Mặc định	Mô tả
`HF_XET_CHUNK_CACHE_SIZE_BYTES`	—	Không còn được sử dụng bởi `hf_xet`. Việc đặt giá trị này không kích hoạt bộ nhớ đệm chunk tải xuống.

Ghi nhật ký

Biến môi trường	Mặc định	Mô tả
`HF_XET_LOG_DEST`	Không có	Đích ghi log. Chấp nhận đường dẫn tệp hoặc đường dẫn thư mục (kết thúc bằng `/`). Khi đặt thành thư mục, các tệp log sẽ được tạo với tên có dấu thời gian. Khi đặt thành chuỗi rỗng, log sẽ được ghi ra console. Khi không được đặt, log sẽ được ghi vào thư mục con `logs/` trong thư mục cache Hugging Face Xet.
`HF_XET_LOG_FORMAT`	Không có	Định dạng log. Đặt thành `json` cho log định dạng JSON; ngược lại là văn bản thuần túy. Mặc định, ghi log vào tệp dùng JSON và ghi log ra console dùng văn bản.
`HF_XET_LOG_PREFIX`	`xet`	Tiền tố cho tên tệp nhật ký khi ghi nhật ký vào một thư mục.
`HF_XET_LOG_DIR_DISABLE_CLEANUP`	`false`	Tắt dọn dẹp tự động các tệp nhật ký cũ trong thư mục nhật ký.
`HF_XET_LOG_DIR_MAX_SIZE`	`250mb`	Tổng kích thước tối đa của các tệp nhật ký trong thư mục nhật ký. Các tệp cũ sẽ bị xóa để duy trì dưới ngưỡng này.
`HF_XET_LOG_DIR_MIN_DELETION_AGE`	`1d`	Tuổi tối thiểu trước khi một tệp nhật ký có thể bị xóa trong quá trình dọn dẹp.
`HF_XET_LOG_DIR_MAX_RETENTION_AGE`	`14d`	Tuổi tối đa của các tệp nhật ký. Các tệp cũ hơn mức này sẽ luôn bị xóa trong quá trình dọn dẹp.

Telemetry

hf_xet gửi một báo cáo ngắn sau mỗi lần tải lên và tải xuống. Xem Telemetry để biết nội dung của nó. Để tắt tính năng này, hãy đặt HF_HUB_DISABLE_TELEMETRY=1.

Hạn chế hiện tại

Mặc dù Xet mang lại khả năng khử trùng lặp chi tiết và hiệu năng được cải thiện cho lưu trữ dựa trên Git, một số tính năng và khả năng tương thích nền tảng vẫn đang trong quá trình phát triển. Do đó, hãy lưu ý các ràng buộc sau khi làm việc với một kho lưu trữ được bật Xet:

Chỉ dành cho hệ thống 64-bit: Cả hf_xet và Git Xet hiện đều yêu cầu kiến trúc 64-bit; các hệ thống 32-bit không được hỗ trợ.

Update on GitHub

←Xét Lịch sử & Tổng quan Bảo mật→