Skip to content

Commit 7725807

Browse files
JibrilElJibrilElWauplin
authored
[i18n-FR] Translated "Integrations" to french (sub PR of 1900) (#2329)
* Translated toctree & git_vs_htttp * Translated the cli guide * Testing to see if user is well configured * TEsting to see if branch is well configured * Translated index * Translated quick-start * Corrected a minor error in the english doc * Reverting a wrong change * Translated installation.md * Translated community.md * Translated download.md * Translated hf_file_system.md * Translated inference_client * Translated inference_endpoints.md * Fixed a few errors in the translation * Translated integrations.md * Translated mana-cache.md. Did not find a good translfation for cache-system * Translated manage-space.md * Translated overview.md * Translated package-reference file * Translated hf_api, login, mixins, repository, space_runtime and tensorboard in the package reference * Finished the translation of package reference by translating utilities and webhooks servers * Translated model-cards.md * Translated collections.md * translated community.md * Translated download.md, corrected an error in the english version and changed a n inacurrate translation in other files * translated hf_file_system * Translated inference_endpoints.md * Translated inference.md * translated repository.md * Translated search.md * Translated webhooks_server.md * corrected webhooks * Translated upload.md * Added "fr" to .github/workflow * Deleted redirects as it is not needed * Corrected toctree.yml * Corrected errors o quick-start.md * Corrected installation.md * Changed the translation of the product "space" in the whole documentation. * Corrected git_vs_http * Corrected CLI.md * Corrected collections.md * Corrected community.md * Corrected download.md * Corrected hf_file_system * Correction of docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Corrected git vs http and index.md * Finished correcting index.md * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/installation.md Co-authored-by: Lucain <[email protected]> * Finished correcting index.md * Corrected inference endpoint, a lot of mistakes might have to look at it again * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/concepts/git_vs_http.md Co-authored-by: Lucain <[email protected]> * Deleted files * Revert "Deleted files" This reverts commit 34c49a7. * Deleted files * Deleted files * Delete files * Update docs/source/fr/_toctree.yml Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> * Update docs/source/fr/guides/integrations.md Co-authored-by: Lucain <[email protected]> --------- Co-authored-by: JibrilEl <[email protected]> Co-authored-by: Lucain <[email protected]>
1 parent 67686d6 commit 7725807

File tree

2 files changed

+279
-1
lines changed

2 files changed

+279
-1
lines changed

‎docs/source/fr/_toctree.yml‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,7 @@
99
- title: "Concepts"
1010
sections:
1111
- local: concepts/git_vs_http
12-
title: Git ou HTTP?
12+
title: Git ou HTTP?
13+
- title: "Guides"
14+
- local: guides/integrations
15+
title: Intégrer dans une librarie

‎docs/source/fr/guides/integrations.md‎

Lines changed: 275 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,275 @@
1+
<!--⚠️ Note that this file is in Markdown but contain specific syntax for our doc-builder (similar to MDX) that may not be
2+
rendered properly in your Markdown viewer.
3+
-->
4+
5+
# Intégrez votre framework de ML avec le Hub
6+
7+
Le Hugging Face Hub facilite l'hébergement et le partage de modèles et de jeux de données.
8+
Des [dizaines de librairies](https://huggingface.co/docs/hub/models-libraries) sont intégrées à cet écosysteme. La communauté travaille constamment à en intégrer de nouvelles et contribue ainsi à faciliter la collaboration dans le milieu du machine learning. La librairie `huggingface_hub` joue un rôle clé dans ce processus puisqu'elle permet d'interagir avec le Hub depuis n'importe quel script Python.
9+
10+
Il existe quatre façons principales d'intégrer une bibliothèque au Hub :
11+
1. **Push to Hub** implémente une méthode pour upload un modèle sur le Hub. Cela inclut les paramètres du modèle, sa fiche descriptive (appelée [Model Card](https://huggingface.co/docs/huggingface_hub/how-to-model-cards)) et toute autre information pertinente lié au modèle (par exemple, les logs d'entrainement). Cette méthode est souvent appelée `push_to_hub()`.
12+
2. **Download from Hub** implémente une méthode pour charger un modèle depuis le Hub. La méthode doit télécharger la configuration et les poids du modèle puis instancier celui-ci. Cette méthode est souvent appelée `from_pretrained` ou `load_from_hub()`.
13+
3. **Inference API** utilise nos serveurs pour faire de l'inférence gratuitement sur des modèles supportés par votre librairie.
14+
4. **Widgets** affiche un widget sur la page d'accueil de votre modèle dans le Hub. Les widgets permettent aux utilisateurs de rapidement tester un modèle depuis le navigateur.
15+
16+
Dans ce guide, nous nous concentreront sur les deux premiers sujets. Nous présenterons les deux approches principales que vous pouvez utiliser pour intégrer une librairie, avec leurs avantages et leurs inconvénients. Tout est résumé à la fin du guide pour vous aider à choisir entre les deux. Veuillez garder à l'esprit que ce ne sont que des conseils, et vous êtes libres de les adapter à votre cas d'usage.
17+
18+
Si l'Inference API et les Widgets vous intéressent, vous pouvez suivre [ce guide](https://huggingface.co/docs/hub/models-adding-libraries#set-up-the-inference-api). Dans les deux cas, vous pouvez nous contacter si vous intégrez une librairie au Hub et que vous voulez être listée [dans la documentation officielle](https://huggingface.co/docs/hub/models-libraries).
19+
20+
## Une approche flexible: les helpers
21+
22+
La première approche pour intégrer une librairie au Hub est d'implémenter les méthodes `push_to_hub` et `from_pretrained`
23+
vous même. Ceci vous donne une flexibilité totale sur le choix du fichier que vous voulez upload/download et sur comment
24+
gérer les inputs spécifiques à votre framework. Vous pouvez vous référer aux guides : [upload des fichiers](./upload)
25+
et [télécharger des fichiers](./download) pour en savoir plus sur la manière de faire. Par example, c'est de cette manière que l'intégration
26+
de FastAI est implémentée (voir [`push_to_hub_fastai`] et [`from_pretrained_fastai`]).
27+
28+
L'implémentation peut varier entre différentes librairies, mais le workflow est souvent similaire.
29+
30+
### from_pretrained
31+
32+
Voici un exemple classique pour implémenter la méthode `from_pretrained`:
33+
34+
```python
35+
def from_pretrained(model_id: str) -> MyModelClass:
36+
# Téléchargement des paramètres depuis le Hub
37+
cached_model = hf_hub_download(
38+
repo_id=repo_id,
39+
filename="model.pkl",
40+
library_name="fastai",
41+
library_version=get_fastai_version(),
42+
)
43+
44+
# Instanciation du modèle
45+
return load_model(cached_model)
46+
```
47+
48+
### push_to_hub
49+
50+
La méthode `push_to_hub` demande souvent un peu plus de complexité pour gérer la création du dépôt git, générer la model card et enregistrer les paramètres.
51+
Une approche commune est de sauvegarder tous ces fichiers dans un dossier temporaire, les transférer sur le Hub avant de les supprimer localement.
52+
53+
```python
54+
def push_to_hub(model: MyModelClass, repo_name: str) -> None:
55+
api = HfApi()
56+
57+
# Créez d'un dépôt s'il n'existe pas encore, et obtenez le repo_id associé
58+
repo_id = api.create_repo(repo_name, exist_ok=True).repo_id
59+
60+
# Sauvegardez tous les fichiers dans un chemin temporaire, et pushez les en un seul commit
61+
with TemporaryDirectory() as tmpdir:
62+
tmpdir = Path(tmpdir)
63+
64+
# Sauvegardez les poids
65+
save_model(model, tmpdir / "model.safetensors")
66+
67+
# Générez la model card
68+
card = generate_model_card(model)
69+
(tmpdir / "README.md").write_text(card)
70+
71+
# Sauvegardez les logs
72+
# Sauvegardez le métriques d'évaluation
73+
# ...
74+
75+
# Pushez vers le Hub
76+
return api.upload_folder(repo_id=repo_id, folder_path=tmpdir)
77+
```
78+
79+
Ceci n'est qu'un exemple. Si vous êtes intéressés par des manipulations plus complexes (supprimer des fichiers distants,
80+
upload des poids à la volée, maintenir les poids localement, etc.) consultez le guide [upload des fichiers](./upload).
81+
82+
### Limitations
83+
84+
Bien que très flexible, cette approche a quelques défauts, particulièrement en terme de maintenance. Les utilisateurs
85+
d'Hugging Face sont habitués à utiliser des certaines fonctionnalités lorsqu'ils travaillent avec `huggingface_hub`. Par exemple,
86+
lors du chargement de fichiers depuis le Hub, il est commun de passer des paramètres tels que:
87+
- `token`: pour télécharger depuis un dépôt privé
88+
- `revision`: pour télécharger depuis une branche spécifique
89+
- `cache_dir`: pour paramétrer la mise en cache des fichiers
90+
- `force_download`: pour désactiver le cache
91+
- `api_endpoint`/`proxies`: pour configurer la session HTTP
92+
93+
Lorsque vous pushez des modèles, des paramètres similaires sont utilisables:
94+
- `commit_message`: message de commit personnalisé
95+
- `private`: créé un dépôt privé s'il en manque un
96+
- `create_pr`: créé un pull request au lieu de push vers `main`
97+
- `branch`: push vers une branche au lieu de push sur `main`
98+
- `allow_patterns`/`ignore_patterns`: filtre les fichiers à upload
99+
- `token`
100+
- `api_endpoint`
101+
- ...
102+
103+
Tous ces paramètres peuvent être ajoutés aux implémentations vues ci dessus et passés aux méthodes de `huggingface_hub`.
104+
Toutefois, si un paramètre change ou qu'une nouvelle fonctionnalité est ajoutée, vous devrez mettre à jour votre package.
105+
Supporter ces paramètres implique aussi plus de documentation à maintenir de votre côté. Dans la prochaine section, nous allons voir comment dépasser ces limitations.
106+
107+
## Une approche plus complexe: l'héritage de classe
108+
109+
Comme vu ci-dessus, deux méthodes principales sont à inclure dans votre librairie pour l'intégrer avec le Hub:
110+
la méthode permettant d'upload des fichiers (`push_to_hub`) et celle pour télécharger des fichiers (`from_pretrained`).
111+
Vous pouvez implémenter ces méthodes vous-même mais cela a des inconvénients. Pour gérer ça, `huggingface_hub` fournit
112+
un outil qui utilise l'héritage de classe. Regardons comment ça marche !
113+
114+
Dans beaucoup de cas, une librairie définit déjà les modèles comme des classes Python. La classe contient les
115+
propriétés du modèle et des méthodes pour charger, lancer, entrainer et évaluer le modèle. Notre approche est d'étendre
116+
cette classe pour inclure les fonctionnalités upload et download en utilisant les mixins. Une [mixin](https://stackoverflow.com/a/547714)
117+
est une classe qui est faite pour étendre une classe existante avec une liste de fonctionnalités spécifiques en utilisant l'héritage de classe.
118+
`huggingface_hub` offre son propre mixin, le [`ModelHubMixin`]. La clef ici est de comprendre son comportement et comment le customiser.
119+
120+
La classe [`ModelHubMixin`] implémente 3 méthodes *public* (`push_to_hub`, `save_pretrained` et `from_pretrained`). Ce
121+
sont les méthodes que vos utilisateurs appeleront pour charger/enregistrer des modèles avec votre librairie.
122+
[`ModelHubMixin`] définit aussi 2 méthodes *private* (`_save_pretrained` et `from_pretrained`). Ce sont celle que vous
123+
devez implémenter. Ainsi, pour intégrer votre librairie, vous devez :
124+
125+
1. Faire en sorte que votre classe Model hérite de [`ModelHubMixin`].
126+
2. Implémenter les méthodes privées:
127+
- [`~ModelHubMixin._save_pretrained`]: méthode qui prend en entrée un chemin vers un directory et qui sauvegarde le modèle.
128+
Vous devez écrire toute la logique pour dump votre modèle de cette manière: model card, poids du modèle, fichiers de configuration,
129+
et logs d'entrainement. Toute information pertinente pour ce modèle doit être gérée par cette méthode. Les
130+
[model cards](https://huggingface.co/docs/hub/model-cards) sont particulièrement importantes pour décrire votre modèle. Vérifiez
131+
[notre guide d'implémentation](./model-cards) pour plus de détails.
132+
- [`~ModelHubMixin._from_pretrained`]: **méthode de classe** prenant en entrée un `model_id` et qui retourne un modèle instancié.
133+
Cette méthode doit télécharger un ou plusieurs fichier(s) et le(s) charger.
134+
3. Fini!
135+
136+
L'avantage d'utiliser [`ModelHubMixin`] est qu'une fois que vous vous êtes occupés de la sérialisation et du chargement du fichier,
137+
vous êtes prêts. Vous n'avez pas besoin de vous soucier de la création du dépôt, des commits, des pull requests ou des révisions.
138+
Tout ceci est géré par le mixin et est disponible pour vos utilisateurs. Le Mixin s'assure aussi que les méthodes publiques sont
139+
bien documentées et que les annotations de typage sont spécifiées.
140+
141+
### Un exemple concret: PyTorch
142+
143+
Un bon exemple de ce que nous avons vu ci-dessus est [`PyTorchModelHubMixin`], notre intégration pour le framework PyTorch.
144+
C'est une intégration prête à l'emploi.
145+
146+
#### Comment l'utiliser ?
147+
148+
Voici comment n'importe quel utilisateur peut charger/enregistrer un modèle Pytorch depuis/vers le Hub:
149+
150+
```python
151+
>>> import torch
152+
>>> import torch.nn as nn
153+
>>> from huggingface_hub import PyTorchModelHubMixin
154+
155+
# 1. Définissez votre modèle Pytorch exactement comme vous êtes habitués à le faire
156+
>>> class MyModel(nn.Module, PyTorchModelHubMixin): # héritage multiple
157+
... def __init__(self):
158+
... super().__init__()
159+
... self.param = nn.Parameter(torch.rand(3, 4))
160+
... self.linear = nn.Linear(4, 5)
161+
162+
... def forward(self, x):
163+
... return self.linear(x + self.param)
164+
>>> model = MyModel()
165+
166+
# 2. (optionnel) Sauvegarder le modèle dans un chemin local
167+
>>> model.save_pretrained("path/to/my-awesome-model")
168+
169+
# 3. Pushez les poids du modèle vers le Hub
170+
>>> model.push_to_hub("my-awesome-model")
171+
172+
# 4. initialisez le modèle depuis le Hub
173+
>>> model = MyModel.from_pretrained("username/my-awesome-model")
174+
```
175+
176+
#### Implémentation
177+
178+
L'implémentation est très succincte (voir [ici](https://github.com/huggingface/huggingface_hub/blob/main/src/huggingface_hub/hub_mixin.py)).
179+
180+
1. Premièrement, faites hériter votre classe de `ModelHubMixin`:
181+
182+
```python
183+
from huggingface_hub import ModelHubMixin
184+
185+
class PyTorchModelHubMixin(ModelHubMixin):
186+
(...)
187+
```
188+
189+
2. Implémentez la méthode `_save_pretrained`:
190+
191+
```py
192+
from huggingface_hub import ModelCard, ModelCardData
193+
194+
class PyTorchModelHubMixin(ModelHubMixin):
195+
(...)
196+
197+
def _save_pretrained(self, save_directory: Path):
198+
"""Générez une model card et enregistrez les poids d'un modèle Pytroch vers un chemin local."""
199+
model_card = ModelCard.from_template(
200+
card_data=ModelCardData(
201+
license='mit',
202+
library_name="pytorch",
203+
...
204+
),
205+
model_summary=...,
206+
model_type=...,
207+
...
208+
)
209+
(save_directory / "README.md").write_text(str(model))
210+
torch.save(obj=self.module.state_dict(), f=save_directory / "pytorch_model.bin")
211+
```
212+
213+
3. Implémentez la méthode `_from_pretrained`:
214+
215+
```python
216+
class PyTorchModelHubMixin(ModelHubMixin):
217+
(...)
218+
219+
@classmethod # Doit absolument être une méthode de clase !
220+
def _from_pretrained(
221+
cls,
222+
*,
223+
model_id: str,
224+
revision: str,
225+
cache_dir: str,
226+
force_download: bool,
227+
proxies: Optional[Dict],
228+
resume_download: bool,
229+
local_files_only: bool,
230+
token: Union[str, bool, None],
231+
map_location: str = "cpu", # argument supplémentaire
232+
strict: bool = False, # argument supplémentaire
233+
**model_kwargs,
234+
):
235+
"""Chargez les poids pré-entrainés et renvoyez les au modèle chargé."""
236+
if os.path.isdir(model_id): # Peut être un chemin local
237+
print("Loading weights from local directory")
238+
model_file = os.path.join(model_id, "pytorch_model.bin")
239+
else: # Ou un modèle du Hub
240+
model_file = hf_hub_download( # Téléchargez depuis le Hub, en passant le mêmes arguments d'entrée
241+
repo_id=model_id,
242+
filename="pytorch_model.bin",
243+
revision=revision,
244+
cache_dir=cache_dir,
245+
force_download=force_download,
246+
proxies=proxies,
247+
resume_download=resume_download,
248+
token=token,
249+
local_files_only=local_files_only,
250+
)
251+
252+
# Chargez le modèle et reoutnez une logique personnalisée dépendant de votre framework
253+
model = cls(**model_kwargs)
254+
state_dict = torch.load(model_file, map_location=torch.device(map_location))
255+
model.load_state_dict(state_dict, strict=strict)
256+
model.eval()
257+
return model
258+
```
259+
260+
Et c'est fini ! Votre librairie permet maintenant aux utilisateurs d'upload et de télécharger des fichiers vers et depuis le Hub.
261+
262+
## Comparaison
263+
264+
Résumons rapidement les deux approches que nous avons vu avec leurs avantages et leurs défauts. Le tableau ci-dessous
265+
est purement indicatif. Votre framework aura peut-êre des spécifités à prendre en compte. Ce guide
266+
est ici pour vous donner des indications et des idées sur comment gérer l'intégration. Dans tous les cas,
267+
n'hésitez pas à nous contacter si vous avez une question !
268+
269+
<!-- Généré en utilisant https://www.tablesgenerator.com/markdown_tables -->
270+
| Intégration | Utilisant des helpers | Utilisant [`ModelHubMixin`] |
271+
|:---:|:---:|:---:|
272+
| Expérience utilisateur | `model = load_from_hub(...)`<br>`push_to_hub(model, ...)` | `model = MyModel.from_pretrained(...)`<br>`model.push_to_hub(...)` |
273+
| Flexible | Très flexible.<br>Vous controllez complètement l'implémentation. | Moins flexible.<br>Votre framework doit avoir une classe de modèle. |
274+
| Maintenance | Plus de maintenance pour ajouter du support pour la configuration, et de nouvelles fonctionnalités. Peut aussi nécessiter de fixx des problèmes signalés par les utilisateurs.| Moins de maintenance vu que la plupart des intégrations avec le Hub sont implémentés dans `huggingface_hub` |
275+
| Documentation / Anotation de type| A écrire à la main | Géré partiellement par `huggingface_hub`. |

0 commit comments

Comments
 (0)