Update Label Studio docs to recommend Storage Buckets for persistence#2381
Update Label Studio docs to recommend Storage Buckets for persistence#2381davanstrien merged 3 commits intomainfrom
Conversation
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
|
The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update. |
|
cc @christophe-rannou for viz |
| hf buckets create <your-namespace>/label-studio-data | ||
| ``` | ||
|
|
||
| 2. **Attach it** in Space Settings → Storage Buckets, mount path `/data`. |
There was a problem hiding this comment.
maybe show via CLI or code too
There was a problem hiding this comment.
Updated to make it more agent-friendly!
cc @Wauplin @hanouticelina - any objections to a PR for adding mounting volumes to hf CLI? Might be quicker for agents vs the current approach in these docs.
There was a problem hiding this comment.
Yes sure! We actually have quite a lot of Space-specific methods in the API that would deserve to be in the CLI:
As a side note, it's already possible to attach a volume when creating the Space:
hf repos create ... --repo-type -v hf://gpt2:/models
(still agree on the need for a hf spaces volume ...)
There was a problem hiding this comment.
…e setup Addresses Julien's review on #2381 — shows the equivalent Python flow (set_space_volumes / add_space_variable / restart_space) so the setup can be handed off to a coding agent instead of clicking through Space settings. Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
|
I'll merge this as is for now, but will update once huggingface/huggingface_hub#4109 lands in a release. |
4 participants
Summary
Aligns with the Space template PR that just merged: https://huggingface.co/spaces/LabelStudio/LabelStudio/discussions/8
Working example: https://huggingface.co/spaces/davanstrien/label-studio-buckets-demo
🤖 Generated with Claude Code
Note
Low Risk
Low risk: documentation-only changes with no runtime or API impact; risk limited to potential user confusion if instructions are inaccurate.
Overview
Updates the Label Studio on Spaces guide to emphasize persistent storage via HF Storage Buckets: the ephemeral-storage warning now links to a new persistence section and the production checklist calls out buckets as the default persistence option.
Adds a step-by-step "Enable Persistence with HF Storage Buckets" walkthrough (including required variables
LABEL_STUDIO_BASE_DATA_DIR/STORAGE_PERSISTENCE, optionalSECRET_KEY, and an optionalhuggingface_hubautomation snippet), and renames/positions the existing database guidance as "Enable Persistence with Postgres" for heavier deployments.Reviewed by Cursor Bugbot for commit 7438612. Bugbot is set up for automated code reviews on this repo. Configure here.