Skip to content

Commit 5ee19a9

Browse files
i18n: add French README translation (#3490)
* [Documentation] Add French README file * Fix formatting in language links section of README.md
1 parent ff961ea commit 5ee19a9

File tree

2 files changed

+162
-1
lines changed

2 files changed

+162
-1
lines changed

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,10 @@
2424
<p>
2525
<b>English</b> |
2626
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_de.md">Deutsch</a> |
27+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_fr.md">Français</a> |
2728
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_hi.md">हिंदी</a> |
2829
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_ko.md">한국어</a> |
29-
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_cn.md">中文(简体)</a>
30+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_cn.md">中文 (简体)</a>
3031
<p>
3132
</h4>
3233

i18n/README_fr.md

Lines changed: 160 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,160 @@
1+
<p align="center">
2+
<picture>
3+
<source media="(prefers-color-scheme: dark)" srcset="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub-dark.svg">
4+
<source media="(prefers-color-scheme: light)" srcset="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg">
5+
<img alt="logo de la bibliothèque huggingface_hub" src="https://huggingface.co/datasets/huggingface/documentation-images/raw/main/huggingface_hub.svg" width="352" height="59" style="max-width: 100%;">
6+
</picture>
7+
<br/>
8+
<br/>
9+
</p>
10+
11+
<p align="center">
12+
<i>Le client Python officiel pour le Huggingface Hub.</i>
13+
</p>
14+
15+
<p align="center">
16+
<a href="https://huggingface.co/docs/huggingface_hub/en/index"><img alt="Documentation" src="https://img.shields.io/website/http/huggingface.co/docs/huggingface_hub/index.svg?down_color=red&down_message=offline&up_message=online&label=doc"></a>
17+
<a href="https://github.com/huggingface/huggingface_hub/releases"><img alt="Version GitHub" src="https://img.shields.io/github/release/huggingface/huggingface_hub.svg"></a>
18+
<a href="https://github.com/huggingface/huggingface_hub"><img alt="Version PyPI" src="https://img.shields.io/pypi/pyversions/huggingface_hub.svg"></a>
19+
<a href="https://pypi.org/project/huggingface-hub"><img alt="PyPI - Téléchargements" src="https://img.shields.io/pypi/dm/huggingface_hub"></a>
20+
<a href="https://codecov.io/gh/huggingface/huggingface_hub"><img alt="Couverture du code" src="https://codecov.io/gh/huggingface/huggingface_hub/branch/main/graph/badge.svg?token=RXP95LE2XL"></a>
21+
</p>
22+
23+
<h4 align="center">
24+
<p>
25+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/README.md">English</a> |
26+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_de.md">Deutsch</a> |
27+
<b>Français</b> |
28+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_hi.md">हिंदी</a> |
29+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_ko.md">한국어</a> |
30+
<a href="https://github.com/huggingface/huggingface_hub/blob/main/i18n/README_cn.md">中文 (简体)</a>
31+
</h4>
32+
33+
---
34+
35+
**Documentation** : <a href="https://hf.co/docs/huggingface_hub" target="_blank">https://hf.co/docs/huggingface_hub</a>
36+
37+
**Code source** : <a href="https://github.com/huggingface/huggingface_hub" target="_blank">https://github.com/huggingface/huggingface_hub</a>
38+
39+
---
40+
41+
## Bienvenue sur la bibliothèque huggingface_hub
42+
43+
La bibliothèque `huggingface_hub` vous permet d’interagir avec le [Hugging Face Hub](https://huggingface.co/), cette plateforme démocratise le Machine Learning en open source pour les créateurs et les collaborateurs du monde entier. Découvrez des modèles et des jeux de données pré-entraînés pour vos projets, ou amusez-vous avec les milliers d’applications de machine learning hébergées sur le Hub. Vous pouvez aussi créer et partager vos propres modèles, vos jeux de données, vos démos avec la communauté. La bibliothèque `huggingface_hub` vous permet de faire ça simplement avec Python.
44+
45+
## Fonctionnalités clés
46+
47+
- [Télécharger des fichiers](https://huggingface.co/docs/huggingface_hub/en/guides/download) depuis le Hub.
48+
- [Téléverser des fichiers](https://huggingface.co/docs/huggingface_hub/en/guides/upload) vers le Hub.
49+
- [Gérer vos dépôts](https://huggingface.co/docs/huggingface_hub/en/guides/repository).
50+
- [Exécuter l’inférence](https://huggingface.co/docs/huggingface_hub/en/guides/inference) sur des modèles déployés.
51+
- [Rechercher](https://huggingface.co/docs/huggingface_hub/en/guides/search) des modèles, des jeux de données et des Spaces.
52+
- [Partager des Model Cards](https://huggingface.co/docs/huggingface_hub/en/guides/model-cards) pour documenter vos modèles.
53+
- [Interagir avec la communauté](https://huggingface.co/docs/huggingface_hub/en/guides/community) via des PR et des commentaires.
54+
55+
## Installation
56+
57+
Installez le paquet `huggingface_hub` avec [pip](https://pypi.org/project/huggingface-hub/) :
58+
59+
```bash
60+
pip install huggingface_hub
61+
```
62+
63+
Si vous préférez, vous pouvez aussi l’installer avec [conda](https://huggingface.co/docs/huggingface_hub/en/installation#install-with-conda).
64+
65+
Afin de garder le paquet minimal par défaut, `huggingface_hub` vient avec des dépendances optionnelles utiles pour certains cas d’usage. Par exemple, si vous voulez faire de l’inférence, exécutez :
66+
67+
```bash
68+
pip install "huggingface_hub[inference]"
69+
```
70+
71+
Pour en savoir plus sur l'installation et les dépendances optionnelles, consultez le [guide d’installation](https://huggingface.co/docs/huggingface_hub/en/installation).
72+
73+
## Démarrage rapide
74+
75+
### Télécharger des fichiers
76+
77+
Télécharger un seul fichier
78+
79+
```py
80+
from huggingface_hub import hf_hub_download
81+
82+
hf_hub_download(repo_id="tiiuae/falcon-7b-instruct", filename="config.json")
83+
```
84+
85+
Ou un dépôt entier
86+
87+
```py
88+
from huggingface_hub import snapshot_download
89+
90+
snapshot_download("stabilityai/stable-diffusion-2-1")
91+
```
92+
93+
Les fichiers seront téléchargés dans un dossier de cache local. Pour plus d'informations, consultez [ce guide](https://huggingface.co/docs/huggingface_hub/en/guides/manage-cache).
94+
95+
### Connexion
96+
97+
Le Hugging Face Hub utilise des jetons d'authentification pour les applications (voir [docs](https://huggingface.co/docs/hub/security-tokens)). Pour vous connecter sur votre machine, exécutez la commande CLI suivante :
98+
99+
```bash
100+
hf auth login
101+
# ou en utilisant une variable d'environnement
102+
hf auth login --token $HUGGINGFACE_TOKEN
103+
```
104+
105+
### Créer un dépôt
106+
107+
```py
108+
from huggingface_hub import create_repo
109+
110+
create_repo(repo_id="super-cool-model")
111+
```
112+
113+
### Téléverser des fichiers
114+
115+
Téléverser un seul fichier
116+
117+
```py
118+
from huggingface_hub import upload_file
119+
120+
upload_file(
121+
path_or_fileobj="/home/lysandre/dummy-test/README.md",
122+
path_in_repo="README.md",
123+
repo_id="lysandre/test-model",
124+
)
125+
```
126+
127+
Ou un dossier entier
128+
129+
```py
130+
from huggingface_hub import upload_folder
131+
132+
upload_folder(
133+
folder_path="/path/to/local/space",
134+
repo_id="username/my-cool-space",
135+
repo_type="space",
136+
)
137+
```
138+
139+
Pour plus de détails, consultez le [guide de téléversement](https://huggingface.co/docs/huggingface_hub/en/guides/upload).
140+
141+
## Intégrer votre bibliothèque au Hub
142+
143+
Nous collaborons avec des bibliothèques de machine learning open source pour offrir gratuitement de l’hébergement et du versionnage de modèles. Vous pouvez trouver les intégrations existantes [ici](https://huggingface.co/docs/hub/libraries).
144+
145+
Les avantages sont :
146+
147+
- Hébergement gratuit de modèles et des jeux de données pour les bibliothèques et leurs utilisateurs.
148+
- Versionnage des fichiers — y compris très volumineux — grâce à Git.
149+
- Widgets interactifs dans le navigateur pour essayer les modèles mis en ligne.
150+
- N’importe qui peut téléverser un nouveau modèle pour votre bibliothèque, il suffit d’ajouter l’étiquette correspondante pour que le modèle soit disponible.
151+
- Téléchargements rapides ! Nous utilisons CloudFront (un CDN) pour géo-répliquer les téléchargements afin qu’ils soient ultra rapides partout dans le monde.
152+
- Statistiques d’utilisation et d’autres fonctionnalités à venir.
153+
154+
Si vous souhaitez intégrer votre bibliothèque, n’hésitez pas à ouvrir une issue pour lancer la discussion. Nous avons écrit un [guide pas à pas](https://huggingface.co/docs/hub/adding-a-library) avec ❤️ pour vous accompagner.
155+
156+
## Les contributions (demandes de fonctionnalité, bugs, etc.) sont les bienvenues 💙💚💛💜🧡❤️
157+
158+
Tout le monde est le bienvenu pour contribuer, et nous valorisons la contribution de chacun. Le code n’est pas la seule façon d’aider la communauté.
159+
Répondre aux questions, aider les autres, prendre contact et améliorer la documentation sont immensément précieux pour la communauté.
160+
Nous avons écrit un [guide de contribution](https://github.com/huggingface/huggingface_hub/blob/main/CONTRIBUTING.md) pour vous aider à comprendre comment commencer à contribuer à ce dépôt.

0 commit comments

Comments
 (0)