File: index.md

package info (click to toggle)
huggingface-hub 0.31.1-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 5,092 kB
  • sloc: python: 40,321; makefile: 54
file content (45 lines) | stat: -rw-r--r-- 4,345 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
<!--โš ๏ธ Note that this file is in Markdown but contains specific syntax for our doc-builder (similar to MDX) that may not be
rendered properly in your Markdown viewer.
-->

# ๐Ÿค— Hub ํด๋ผ์ด์–ธํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ [[hub-client-library]]

`huggingface_hub` ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” [Hugging Face Hub](https://hf.co)์™€ ์ƒํ˜ธ์ž‘์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ค๋‹ˆ๋‹ค. Hugging Face Hub๋Š” ์ฐฝ์ž‘์ž์™€ ํ˜‘์—…์ž๋ฅผ ์œ„ํ•œ ๋จธ์‹ ๋Ÿฌ๋‹ ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ์—ฌ๋Ÿฌ๋ถ„์˜ ํ”„๋กœ์ ํŠธ์— ์ ํ•ฉํ•œ ์‚ฌ์ „ ํ›ˆ๋ จ๋œ ๋ชจ๋ธ๊ณผ ๋ฐ์ดํ„ฐ์…‹์„ ๋ฐœ๊ฒฌํ•˜๊ฑฐ๋‚˜, Hub์— ํ˜ธ์ŠคํŒ…๋œ ์ˆ˜๋ฐฑ ๊ฐœ์˜ ๋จธ์‹ ๋Ÿฌ๋‹ ์•ฑ๋“ค์„ ์‚ฌ์šฉํ•ด๋ณด์„ธ์š”. ๋˜ํ•œ, ์—ฌ๋Ÿฌ๋ถ„์ด ๋งŒ๋“  ๋ชจ๋ธ๊ณผ ๋ฐ์ดํ„ฐ์…‹์„ ์ปค๋ฎค๋‹ˆํ‹ฐ์™€ ๊ณต์œ ํ•  ์ˆ˜๋„ ์žˆ์Šต๋‹ˆ๋‹ค. `huggingface_hub` ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ํŒŒ์ด์ฌ์œผ๋กœ ์ด ๋ชจ๋“  ๊ฒƒ์„ ๊ฐ„๋‹จํ•˜๊ฒŒ ํ•  ์ˆ˜ ์žˆ๋Š” ๋ฐฉ๋ฒ•์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

`huggingface_hub` ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•œ [๋น ๋ฅธ ์‹œ์ž‘ ๊ฐ€์ด๋“œ](quick-start)๋ฅผ ์ฝ์–ด๋ณด์„ธ์š”. Hub์—์„œ ํŒŒ์ผ์„ ๋‹ค์šด๋กœ๋“œํ•˜๊ฑฐ๋‚˜, ๋ ˆํฌ์ง€ํ† ๋ฆฌ๋ฅผ ์ƒ์„ฑํ•˜๊ฑฐ๋‚˜, ํŒŒ์ผ์„ ์—…๋กœ๋“œํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ๋ฐฐ์šธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ณ„์† ์ฝ์–ด๋ณด๋ฉด, ๐Ÿค— Hub์—์„œ ์—ฌ๋Ÿฌ๋ถ„์˜ ๋ ˆํฌ์ง€ํ† ๋ฆฌ๋ฅผ ์–ด๋–ป๊ฒŒ ๊ด€๋ฆฌํ•˜๊ณ , ํ† ๋ก ์— ์–ด๋–ป๊ฒŒ ์ฐธ์—ฌํ•˜๊ณ , ์ถ”๋ก  API์— ์–ด๋–ป๊ฒŒ ์ ‘๊ทผํ•˜๋Š”์ง€ ์•Œ์•„๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.


<div class="mt-10">
  <div class="w-full flex flex-col space-y-4 md:space-y-0 md:grid md:grid-cols-2 md:gap-y-4 md:gap-x-5">

    <a class="!no-underline border dark:border-gray-700 p-5 rounded-lg shadow hover:shadow-lg" href="./guides/overview">
      <div class="w-full text-center bg-gradient-to-br from-indigo-400 to-indigo-500 rounded-lg py-1.5 font-semibold mb-5 text-white text-lg leading-relaxed">How-to ๊ฐ€์ด๋“œ</div>
      <p class="text-gray-700">ํŠน์ • ๋ชฉํ‘œ๋ฅผ ๋‹ฌ์„ฑํ•˜๋Š” ๋ฐ ๋„์›€์ด ๋˜๋Š” ์‹ค์šฉ์ ์ธ ๊ฐ€์ด๋“œ์ž…๋‹ˆ๋‹ค. huggingface_hub๋กœ ์‹ค์ œ ๋ฌธ์ œ๋ฅผ ํ•ด๊ฒฐํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ๋ฐฐ์šฐ๋ ค๋ฉด ์ด ๊ฐ€์ด๋“œ๋“ค์„ ์‚ดํŽด๋ณด์„ธ์š”.</p>
    </a>

    <a class="!no-underline border dark:border-gray-700 p-5 rounded-lg shadow hover:shadow-lg" href="./package_reference/overview">
      <div class="w-full text-center bg-gradient-to-br from-purple-400 to-purple-500 rounded-lg py-1.5 font-semibold mb-5 text-white text-lg leading-relaxed">๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๋ ˆํผ๋Ÿฐ์Šค</div>
      <p class="text-gray-700">huggingface_hub์˜ ํด๋ž˜์Šค์™€ ๋ฉ”์†Œ๋“œ์— ๋Œ€ํ•œ ์™„์ „ํ•˜๊ณ  ๊ธฐ์ˆ ์ ์ธ ์„ค๋ช…์ž…๋‹ˆ๋‹ค.</p>
    </a>

    <a class="!no-underline border dark:border-gray-700 p-5 rounded-lg shadow hover:shadow-lg" href="./concepts/git_vs_http">
      <div class="w-full text-center bg-gradient-to-br from-pink-400 to-pink-500 rounded-lg py-1.5 font-semibold mb-5 text-white text-lg leading-relaxed">๊ฐœ๋… ๊ฐ€์ด๋“œ</div>
      <p class="text-gray-700">huggingface_hub์˜ ์ฒ ํ•™์„ ๋” ์ž˜ ์ดํ•ดํ•˜๊ธฐ ์œ„ํ•œ ๊ณ ์ˆ˜์ค€์˜ ์„ค๋ช…์ž…๋‹ˆ๋‹ค.</p>
    </a>

  </div>
</div>

<!--
<a class="!no-underline border dark:border-gray-700 p-5 rounded-lg shadow hover:shadow-lg" href="./tutorials/overview"
  ><div class="w-full text-center bg-gradient-to-br from-blue-400 to-blue-500 rounded-lg py-1.5 font-semibold mb-5 text-white text-lg leading-relaxed">Tutorials</div>
  <p class="text-gray-700">Learn the basics and become familiar with using huggingface_hub to programmatically interact with the ๐Ÿค— Hub!</p>
</a> -->

## ๊ธฐ์—ฌํ•˜๊ธฐ [[contribute]]

`huggingface_hub`์— ๋Œ€ํ•œ ๋ชจ๋“  ๊ธฐ์—ฌ๋ฅผ ํ™˜์˜ํ•˜๋ฉฐ, ์†Œ์ค‘ํžˆ ์ƒ๊ฐํ•ฉ๋‹ˆ๋‹ค! ๐Ÿค— ์ฝ”๋“œ์—์„œ ๊ธฐ์กด์˜ ์ด์Šˆ๋ฅผ ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜ ์ˆ˜์ •ํ•˜๋Š” ๊ฒƒ ์™ธ์—๋„, ๋ฌธ์„œ๋ฅผ ์ •ํ™•ํ•˜๊ณ  ์ตœ์‹ ์œผ๋กœ ์œ ์ง€ํ•˜๋„๋ก ๊ฐœ์„ ํ•˜๊ฑฐ๋‚˜, ์ด์Šˆ์— ๋Œ€ํ•œ ์งˆ๋ฌธ์— ๋‹ตํ•˜๊ฑฐ๋‚˜, ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ๊ฐœ์„ ํ•  ์ˆ˜ ์žˆ๋‹ค๊ณ  ์ƒ๊ฐํ•˜๋Š” ์ƒˆ๋กœ์šด ๊ธฐ๋Šฅ์„ ์š”์ฒญํ•˜๋Š” ๊ฒƒ๋„ ์ปค๋ฎค๋‹ˆํ‹ฐ์— ๋„์›€์ด ๋ฉ๋‹ˆ๋‹ค. ์ƒˆ๋กœ์šด ์ด์Šˆ๋‚˜ ๊ธฐ๋Šฅ ์š”์ฒญ์„ ์ œ์ถœํ•˜๋Š” ๋ฐฉ๋ฒ•, PR์„ ์ œ์ถœํ•˜๋Š” ๋ฐฉ๋ฒ•, ๊ธฐ์—ฌํ•œ ๋‚ด์šฉ์„ ํ…Œ์ŠคํŠธํ•˜์—ฌ ๋ชจ๋“  ๊ฒƒ์ด ์˜ˆ์ƒ๋Œ€๋กœ ์ž‘๋™ํ•˜๋Š”์ง€ ํ™•์ธํ•˜๋Š” ๋ฐฉ๋ฒ• ๋“ฑ์— ๋Œ€ํ•ด ๋” ์•Œ์•„๋ณด๋ ค๋ฉด [๊ธฐ์—ฌ
๊ฐ€์ด๋“œ](https://github.com/huggingface/huggingface_hub/blob/main/CONTRIBUTING.md)๋ฅผ ์‚ดํŽด๋ณด์„ธ์š”.

๊ธฐ์—ฌ์ž๋“ค์€ ๋˜ํ•œ ๋ชจ๋“  ์‚ฌ๋žŒ๋“ค์„ ์œ„ํ•ด ํฌ๊ด„์ ์ด๊ณ  ํ™˜์˜๋ฐ›๋Š” ํ˜‘์—… ๊ณต๊ฐ„์„ ๋งŒ๋“ค๊ธฐ ์œ„ํ•ด ์šฐ๋ฆฌ์˜ [ํ–‰๋™
๊ฐ•๋ น](https://github.com/huggingface/huggingface_hub/blob/main/CODE_OF_CONDUCT.md)์„ ์ค€์ˆ˜ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.