Skip to content

Commit

Permalink
storage regions wording
Browse files Browse the repository at this point in the history
  • Loading branch information
gary149 committed Oct 28, 2024
1 parent a9c9478 commit b625ca2
Showing 1 changed file with 17 additions and 15 deletions.
32 changes: 17 additions & 15 deletions docs/hub/storage-regions.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,55 @@
I'll help improve the wording while keeping changes minimal. Here's my suggestion:

# Storage Regions on the Hub

Regions let you decide where your org's models and datasets will be stored.
Regions allow you to specify where your organization's models and datasets are stored.

<Tip warning={true}>
This feature is part of the <a href="https://huggingface.co/enterprise" target="_blank">Enterprise Hub</a>.
</Tip>

This has two main benefits:
This offers two key benefits:

- Regulatory and legal compliance
- Performance (improved download and upload speeds and latency)
- Performance (faster download/upload speeds and lower latency)

Currently we support the following regions:
Currently available regions:

- US 🇺🇸
- EU 🇪🇺
- coming soon: Asia-Pacific 🌏
- Coming soon: Asia-Pacific 🌏

## How to set up

If your organization is subscribed to Enterprise Hub, you will be able to see the Regions settings page:
Organizations subscribed to Enterprise Hub can access the Regions settings page:

![](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/storage-regions/feature-annotated.png)

On that page you can see:
This page displays:

- an audit of where your organization repos are currently located
- dropdowns to select where your repos will be created
- An audit of your organization's repository locations
- Options to select where new repositories will be stored

## Repository Tag

Any repo (model or dataset) stored in a non-default location will display its Region directly as a tag. That way your organization's members can see at a glance where repos are located.
Any repository (model or dataset) stored in a non-default location displays its Region as a tag, allowing organization members to quickly identify repository locations.

<div class="flex justify-center">
<img class="block" width="400" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/storage-regions/tag-on-repo.png"/>
</div>

## Regulatory and legal compliance

In regulated industries, companies may be required to store data in a specific region.
Regulated industries often require data storage in specific regions.

For companies in the EU, that means you can use the Hub to build ML in a GDPR compliant way: with datasets, models and inference endpoints all stored within EU data centers.
For EU companies, this means you can use the Hub for ML development in a GDPR-compliant manner, with datasets, models and inference endpoints stored in EU data centers.

## Performance

Storing your models or your datasets closer to your team and infrastructure also means significantly improved performance, for both uploads and downloads.
Storing models and datasets closer to your team and infrastructure significantly improves performance for both uploads and downloads.

This makes a big difference considering model weights and dataset files are usually very large.
This impact is substantial given the typically large size of model weights and dataset files.

![](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/storage-regions/upload-speed.png)

As an example, if you are located in Europe and store your repositories in the EU region, you can expect to see ~4-5x faster upload and download speeds vs. if they were stored in the US.
For example, European users storing repositories in the EU region can expect approximately 4-5x faster upload and download speeds compared to US storage.

0 comments on commit b625ca2

Please sign in to comment.