[GH-ISSUE #343] hf3fs_fuse.io is not available. Please install the hf3fs_fuse package. #211

Open
opened 2026-10-26 09:47:11 +00:00 by bsakaguchi · 4 comments
Owner

Originally created by @beausoft on GitHub (Sep 28, 2025).
Original GitHub issue: https://github.com/deepseek-ai/3FS/issues/343

I used hf3fs as the storage backend for hicache in sglang, but I received an error message: hf3fs_fuse.io is not available. Please install the hf3fs_fuse package..
However, when I tried to install it: pip install hf3fs-py-usrbio, I got an error: subprocess.CalledProcessError: Command '['git', 'rev-parse', '--short', 'HEAD']' returned non-zero exit status.
How should I install it?

Originally created by @beausoft on GitHub (Sep 28, 2025). Original GitHub issue: https://github.com/deepseek-ai/3FS/issues/343 I used hf3fs as the storage backend for hicache in sglang, but I received an error message: `hf3fs_fuse.io is not available. Please install the hf3fs_fuse package.`. However, when I tried to install it: `pip install hf3fs-py-usrbio`, I got an error: `subprocess.CalledProcessError: Command '['git', 'rev-parse', '--short', 'HEAD']' returned non-zero exit status`. How should I install it?
Author
Owner

@zhaoweizhang84-ui commented on GitHub (Nov 14, 2025):

您好,我也遇到同样的问题,请问您解决了嘛

<!-- gh-comment-id:3531070936 --> @zhaoweizhang84-ui commented on GitHub (Nov 14, 2025): 您好,我也遇到同样的问题,请问您解决了嘛
Author
Owner

@leihuang-sketch commented on GitHub (Nov 20, 2025):

https://github.com/sgl-project/sglang/tree/main/python/sglang/srt/mem_cache/storage/hf3fs
use step 3. quick install usrbio

<!-- gh-comment-id:3556757409 --> @leihuang-sketch commented on GitHub (Nov 20, 2025): https://github.com/sgl-project/sglang/tree/main/python/sglang/srt/mem_cache/storage/hf3fs use step 3. quick install usrbio
Author
Owner

@beausoft commented on GitHub (Nov 20, 2025):

https://github.com/sgl-project/sglang/tree/main/python/sglang/srt/mem_cache/storage/hf3fs use step 3. quick install usrbio

Before raising this question, I installed according to the instructions in this document. However, the above problem occurred.

<!-- gh-comment-id:3556973512 --> @beausoft commented on GitHub (Nov 20, 2025): > https://github.com/sgl-project/sglang/tree/main/python/sglang/srt/mem_cache/storage/hf3fs use step 3. quick install usrbio Before raising this question, I installed according to the instructions in this document. However, the above problem occurred.
Author
Owner

@leihuang-sketch commented on GitHub (Nov 21, 2025):

@beausoft Have you also executed export LD_LIBRRY-PATH, It seems that the program did not find the corresponding SO library

<!-- gh-comment-id:3561916058 --> @leihuang-sketch commented on GitHub (Nov 21, 2025): @beausoft Have you also executed `export LD_LIBRRY-PATH`, It seems that the program did not find the corresponding SO library
Sign in to join this conversation.
No labels
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
deepseek-ai/3FS#211
No description provided.