import{s as nl,o as al,n as ol}from"../chunks/scheduler.6062bdaf.js";import{S as il,i as pl,g as o,s as n,r as d,A as dl,h as i,f as l,c as a,j as ll,u as c,x as p,k as sl,y as cl,a as s,v as m,d as g,t as r,w as f}from"../chunks/index.4bca734e.js";import{T as ml}from"../chunks/Tip.b9ac1f03.js";import{C as u}from"../chunks/CodeBlock.fa01571c.js";import{H as $,E as gl}from"../chunks/EditOnGithub.74ab2baa.js";function rl(jt){let h,w='반환된 파일 경로는 HF 로컬 캐시의 위치를 가리킵니다. 그러므로 캐시가 손상되지 않도록 파일을 수정하지 않는 것이 좋습니다. 캐시가 어떻게 작동하는지 자세히 알고 싶으시면 <a href="./manage-cache">캐싱 가이드</a>를 참조하세요.';return{c(){h=o("p"),h.innerHTML=w},l(b){h=i(b,"P",{"data-svelte-h":!0}),p(h)!=="svelte-jkdaqs"&&(h.innerHTML=w)},m(b,_t){s(b,h,_t)},p:ol,d(b){b&&l(h)}}}function fl(jt){let h,w,b,_t,_,Tt,y,Je="<code>huggingface_hub</code> 라이브러리는 Hub의 저장소에서 파일을 다운로드하는 기능을 제공합니다. 이 기능은 함수로 직접 사용할 수 있고, 사용자가 만든 라이브러리에 통합하여 Hub와 쉽게 상호 작용할 수 있도록 할 수 있습니다. 이 가이드에서는 다음 내용을 다룹니다:",vt,j,Ze="<li>파일 하나를 다운로드하고 캐시하는 방법</li> <li>리포지토리 전체를 다운로드하고 캐시하는 방법</li> <li>로컬 폴더에 파일을 다운로드하는 방법</li>",Jt,T,Zt,v,He="<code>hf_hub_download()</code> 함수를 사용하면 Hub에서 파일을 다운로드할 수 있습니다. 이 함수는 원격 파일을 다운로드하여 (버전별로) 디스크에 캐시하고, 로컬 파일 경로를 반환합니다.",Ht,M,xt,J,Yt,Z,xe="다운로드할 파일을 선택하기 위해 <code>repo_id</code>, <code>repo_type</code>, <code>filename</code> 매개변수를 사용합니다. <code>repo_type</code> 매개변수를 생략하면 파일은 <code>model</code> 리포의 일부라고 간주됩니다.",Ut,H,qt,x,Lt,Y,Ye="기본적으로 <code>main</code> 브랜치의 최신 버전의 파일이 다운로드됩니다. 그러나 특정 버전의 파일을 다운로드하고 싶을 수도 있습니다. 예를 들어, 특정 브랜치, 태그, 커밋 해시 등에서 파일을 다운로드하고 싶을 수 있습니다. 이 경우 <code>revision</code> 매개변수를 사용하여 원하는 버전을 지정할 수 있습니다:",kt,U,Gt,q,Ue="<strong>참고</strong>: 커밋 해시를 사용할 때는 7자리의 짧은 커밋 해시가 아니라 전체 길이의 커밋 해시를 사용해야 합니다.",Ct,L,It,k,qe="리포지토리에서 파일을 다운로드하는 데 사용할 URL을 만들고 싶은 경우 <code>hf_hub_url()</code> 함수를 사용하여 URL을 반환받을 수 있습니다. 이 함수는 <code>hf_hub_download()</code> 함수가 내부적으로 사용하는 URL을 생성한다는 점을 알아두세요.",Xt,G,Rt,C,Le="<code>snapshot_download()</code> 함수는 특정 버전의 전체 리포지토리를 다운로드합니다. 이 함수는 내부적으로 <code>hf_hub_download()</code> 함수를 사용하므로, 다운로드한 모든 파일은 로컬 디스크에 캐시되어 저장됩니다. 다운로드는 여러 파일을 동시에 받아오기 때문에 빠르게 진행됩니다.",Wt,I,ke="전체 리포지토리를 다운로드하려면 <code>repo_id</code>와 <code>repo_type</code>을 인자로 넘겨주면 됩니다:",Qt,X,Bt,R,Ge="<code>snapshot_download()</code> 함수는 기본적으로 최신 버전의 리포지토리를 다운로드합니다. 특정 버전의 리포지토리를 다운로드하고 싶은 경우, <code>revision</code> 매개변수에 원하는 버전을 지정하면 됩니다:",zt,W,Nt,Q,Pt,B,Ce="<code>snapshot_download()</code> 함수는 리포지토리를 쉽게 다운로드할 수 있도록 해줍니다. 그러나 리포지토리의 모든 내용을 다운로드하고 싶지 않을 수도 있습니다. 예를 들어, <code>.safetensors</code> 가중치만 사용하고 싶다면, 모든 <code>.bin</code> 파일을 다운로드하지 않도록 할 수 있습니다. <code>allow_pattern</code>과 <code>ignore_pattern</code> 매개변수를 사용하여 원하는 파일만 다운로드할 수 있습니다.",Vt,z,Ie='이 매개변수들은 하나의 패턴이나 패턴의 리스트를 받을 수 있습니다. 패턴은 <a href="https://tldp.org/LDP/GNU-Linux-Tools-Summary/html/x11655.htm" rel="nofollow">여기</a>에서 설명된 것처럼 표준 와일드카드(글로빙 패턴)입니다. 패턴 매칭은 <a href="https://docs.python.org/3/library/fnmatch.html" rel="nofollow"><code>fnmatch</code></a>에 기반합니다.',St,N,Xe="예를 들어, <code>allow_patterns</code>를 사용하여 JSON 구성 파일만 다운로드하는 방법은 다음과 같습니다:",Ft,P,Kt,V,Re="반대로 <code>ignore_patterns</code>는 특정 파일을 다운로드에서 제외시킬 수 있습니다. 다음 예제는 <code>.msgpack</code>과 <code>.h5</code> 파일 확장자를 무시하는 방법입니다:",Et,S,At,F,We="마지막으로, 두 가지 매개변수를 함께 사용하여 다운로드를 정확하게 선택할 수 있습니다. 다음은 <code>vocab.json</code>을 제외한 모든 json 및 마크다운 파일을 다운로드하는 예제입니다.",Dt,K,Ot,E,te,A,Qe=`Hub에서 파일을 다운로드하는 가장 좋은 (그리고 기본적인) 방법은 <a href="./manage-cache">캐시 시스템</a>을 사용하는 것입니다.
캐시 위치는 <code>cache_dir</code> 매개변수로 설정하여 지정할 수 있습니다(<code>hf_hub_download()</code>과 <code>snapshot_download()</code>에서 모두 사용 가능).`,ee,D,Be="그러나 파일을 다운로드하여 특정 폴더에 넣고 싶은 경우도 있습니다. 이 기능은 <code>git</code> 명령어가 제공하는 기능과 비슷한 워크플로우를 만들 수 있습니다. 이 경우 <code>local_dir</code>과 <code>local_dir_use_symlinks</code> 매개변수를 사용하여 원하는 대로 파일을 넣을 수 있습니다:",le,O,ze="<li><code>local_dir</code>은 시스템 내의 폴더 경로입니다. 다운로드한 파일은 리포지토리에 있는 것과 같은 파일 구조를 유지합니다. 예를 들어 <code>filename=&quot;data/train.csv&quot;</code>와 <code>local_dir=&quot;path/to/folder&quot;</code>라면, 반환된 파일 경로는 <code>&quot;path/to/folder/data/train.csv&quot;</code>가 됩니다.</li> <li><code>local_dir_use_symlinks</code>는 파일을 로컬 폴더에 어떻게 넣을지 정의합니다.<ul><li>기본 동작(‘자동’)은 작은 파일(5MB 이하)은 복사하고 큰 파일은 심볼릭 링크를 사용하는 것입니다. 심볼릭 링크를 사용하면 대역폭과 디스크 공간을 모두 절약할 수 있습니다. 그러나 심볼릭 링크된 파일을 직접 수정하면 캐시가 손상될 수 있으므로 작은 파일에 대해서는 복사를 사용합니다. 5MB 임계값은 <code>HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD</code> 환경 변수로 설정할 수 있습니다.</li> <li><code>local_dir_use_symlinks=true</code>로 설정하면 디스크 공간을 최대한 절약하기 위해 모든 파일이 심볼릭 링크됩니다. 이는 예를 들어 수천 개의 작은 파일로 이루어진 대용량 데이터 세트를 다운로드할 때 유용합니다.</li> <li>마지막으로 심볼릭 링크를 전혀 사용하지 않으려면 심볼릭 링크를 비활성화하면 됩니다(<code>local_dir_use_symlinks=False</code>). 캐시 디렉토리는 파일이 이미 캐시되었는지 여부를 확인하는 데 계속 사용됩니다. 이미 캐시된 경우 파일이 캐시에서 <strong>복사</strong>됩니다(즉, 대역폭은 절약되지만 디스크 공간이 증가합니다). 파일이 아직 캐시되지 않은 경우 파일을 다운로드하여 로컬 디렉터리에 바로 넣습니다. 즉, 나중에 다른 곳에서 다시 사용하려면 <strong>다시 다운로드</strong>해야 합니다.</li></ul></li>",se,tt,Ne="다음은 다양한 옵션을 요약한 표입니다. 이 표를 참고하여 자신의 사용 사례에 가장 적합한 매개변수를 선택하세요.",ne,et,Pe='<thead><tr><th>파라미터</th> <th align="center">캐시되었는지 여부</th> <th align="center">반환된 파일경로</th> <th align="center">열람 권한</th> <th align="center">수정 권한</th> <th align="center">대역폭의 효율적인 사용</th> <th align="center">디스크의 효율적인 접근</th></tr></thead> <tbody><tr><td><code>local_dir=None</code></td> <td align="center"></td> <td align="center">캐시 속 심볼릭 링크</td> <td align="center">✅</td> <td align="center">❌<br/><em>(저장하면 캐시가 손상됩니다)</em></td> <td align="center">✅</td> <td align="center">✅</td></tr> <tr><td><code>local_dir=&quot;path/to/folder&quot;</code><br/><code>local_dir_use_symlinks=&quot;auto&quot;</code></td> <td align="center"></td> <td align="center">폴더 속 파일 또는 심볼릭 링크</td> <td align="center">✅</td> <td align="center">✅ <em>(소규모 파일의 경우)</em> <br/> ⚠️ <em>(대규모 파일의 경우 저장하기 전에 경로를 생성하지 마세요)</em></td> <td align="center">✅</td> <td align="center">✅</td></tr> <tr><td><code>local_dir=&quot;path/to/folder&quot;</code><br/><code>local_dir_use_symlinks=True</code></td> <td align="center"></td> <td align="center">폴더 속 심볼릭 링크</td> <td align="center">✅</td> <td align="center">⚠️<br/><em>(저장하기 전에 경로를 생성하지 마세요)</em></td> <td align="center">✅</td> <td align="center">✅</td></tr> <tr><td><code>local_dir=&quot;path/to/folder&quot;</code><br/><code>local_dir_use_symlinks=False</code></td> <td align="center">아니오</td> <td align="center">폴더 속 파일</td> <td align="center">✅</td> <td align="center">✅</td> <td align="center">❌<br/><em>(다시 실행하면 파일도 다시 다운로드됩니다)</em></td> <td align="center">⚠️<br/>(여러 폴더에서 실행하면 그만큼 복사본이 생깁니다)</td></tr> <tr><td><code>local_dir=&quot;path/to/folder&quot;</code><br/><code>local_dir_use_symlinks=False</code></td> <td align="center">예</td> <td align="center">폴더 속 파일</td> <td align="center">✅</td> <td align="center">✅</td> <td align="center">⚠️<br/><em>(파일이 캐시되어 있어야 합니다)</em></td> <td align="center">❌<br/><em>(파일이 중복됩니다)</em></td></tr></tbody>',ae,lt,Ve='<strong>참고</strong>: Windows 컴퓨터를 사용하는 경우 심볼릭 링크를 사용하려면 개발자 모드를 켜거나 관리자 권한으로 <code>huggingface_hub</code>를 실행해야 합니다. 자세한 내용은 <a href="../guides/manage-cache#limitations">캐시 제한</a> 섹션을 참조하세요.',oe,st,ie,nt,Se=`터미널에서 <code>huggingface-cli download</code> 명령어를 사용하면 Hub에서 파일을 바로 다운로드할 수 있습니다.
이 명령어는 내부적으로 앞서 설명한 <code>hf_hub_download()</code>과 <code>snapshot_download()</code> 함수를 사용하고, 다운로드한 파일의 로컬 경로를 터미널에 출력합니다:`,pe,at,de,ot,Fe="기본적으로 (<code>huggingface-cli login</code> 명령으로) 로컬에 저장된 토큰을 사용합니다. 직접 인증하고 싶다면, <code>--token</code> 옵션을 사용하세요:",ce,it,me,pt,Ke="여러 파일을 한 번에 다운로드하면 진행률 표시줄이 보이고, 파일이 있는 스냅샷 경로가 반환됩니다:",ge,dt,re,ct,Ee="진행률 표시줄이나 잠재적 경고가 필요 없다면 <code>--quiet</code> 옵션을 사용하세요. 이 옵션은 스크립트에서 다른 명령어로 출력을 넘겨주려는 경우에 유용할 수 있습니다.",fe,mt,he,gt,Ae="기본적으로 파일은 <code>HF_HOME</code> 환경 변수에 정의된 캐시 디렉터리(또는 지정하지 않은 경우 <code>~/.cache/huggingface/hub</code>)에 다운로드됩니다. 캐시 디렉터리는 <code>--cache-dir</code> 옵션으로 변경할 수 있습니다:",ue,rt,be,ft,De=`캐시 디렉터리 구조를 따르지 않고 로컬 폴더에 파일을 다운로드하려면 <code>--local-dir</code> 옵션을 사용하세요.
로컬 폴더로 다운로드하면 이 <a href="https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-local-folder" rel="nofollow">표</a>에 나열된 제한 사항이 있습니다.`,$e,ht,Me,ut,Oe="다른 리포지토리 유형이나 버전에서 파일을 다운로드하거나 glob 패턴을 사용하여 다운로드할 파일을 선택하거나 제외하도록 지정할 수 있는 인수들이 더 있습니다:",we,bt,_e,$t,tl="인수들의 전체 목록을 보려면 다음 명령어를 실행하세요:",ye,Mt,je,wt,Te,yt,ve;return _=new $({props:{title:"Hub에서 파일 다운로드하기",local:"download-files-from-the-hub",headingTag:"h1"}}),T=new $({props:{title:"파일 하나만 다운로드하기",local:"download-a-single-file",headingTag:"h2"}}),M=new ml({props:{$$slots:{default:[rl]},$$scope:{ctx:jt}}}),J=new $({props:{title:"최신 버전에서 파일 다운로드하기",local:"from-latest-version",headingTag:"h3"}}),H=new u({props:{code:"ZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMGhmX2h1Yl9kb3dubG9hZCUwQWhmX2h1Yl9kb3dubG9hZChyZXBvX2lkJTNEJTIybHlzYW5kcmUlMkZhcnhpdi1ubHAlMjIlMkMlMjBmaWxlbmFtZSUzRCUyMmNvbmZpZy5qc29uJTIyKSUwQSUwQWhmX2h1Yl9kb3dubG9hZChyZXBvX2lkJTNEJTIyZ29vZ2xlJTJGZmxldXJzJTIyJTJDJTIwZmlsZW5hbWUlM0QlMjJmbGV1cnMucHklMjIlMkMlMjByZXBvX3R5cGUlM0QlMjJkYXRhc2V0JTIyKQ==",highlighted:`<span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> hf_hub_download
<span class="hljs-meta">&gt;&gt;&gt; </span>hf_hub_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, filename=<span class="hljs-string">&quot;config.json&quot;</span>)
<span class="hljs-string">&#x27;/root/.cache/huggingface/hub/models--lysandre--arxiv-nlp/snapshots/894a9adde21d9a3e3843e6d5aeaaf01875c7fade/config.json&#x27;</span>

<span class="hljs-comment"># 데이터세트의 경우</span>
<span class="hljs-meta">&gt;&gt;&gt; </span>hf_hub_download(repo_id=<span class="hljs-string">&quot;google/fleurs&quot;</span>, filename=<span class="hljs-string">&quot;fleurs.py&quot;</span>, repo_type=<span class="hljs-string">&quot;dataset&quot;</span>)
<span class="hljs-string">&#x27;/root/.cache/huggingface/hub/datasets--google--fleurs/snapshots/199e4ae37915137c555b1765c01477c216287d34/fleurs.py&#x27;</span>`,wrap:!1}}),x=new $({props:{title:"특정 버전에서 파일 다운로드하기",local:"from-specific-version",headingTag:"h3"}}),U=new u({props:{code:"aGZfaHViX2Rvd25sb2FkKHJlcG9faWQlM0QlMjJseXNhbmRyZSUyRmFyeGl2LW5scCUyMiUyQyUyMGZpbGVuYW1lJTNEJTIyY29uZmlnLmpzb24lMjIlMkMlMjByZXZpc2lvbiUzRCUyMnYxLjAlMjIpJTBBJTBBaGZfaHViX2Rvd25sb2FkKHJlcG9faWQlM0QlMjJseXNhbmRyZSUyRmFyeGl2LW5scCUyMiUyQyUyMGZpbGVuYW1lJTNEJTIyY29uZmlnLmpzb24lMjIlMkMlMjByZXZpc2lvbiUzRCUyMnRlc3QtYnJhbmNoJTIyKSUwQSUwQWhmX2h1Yl9kb3dubG9hZChyZXBvX2lkJTNEJTIybHlzYW5kcmUlMkZhcnhpdi1ubHAlMjIlMkMlMjBmaWxlbmFtZSUzRCUyMmNvbmZpZy5qc29uJTIyJTJDJTIwcmV2aXNpb24lM0QlMjJyZWZzJTJGcHIlMkYzJTIyKSUwQSUwQWhmX2h1Yl9kb3dubG9hZChyZXBvX2lkJTNEJTIybHlzYW5kcmUlMkZhcnhpdi1ubHAlMjIlMkMlMjBmaWxlbmFtZSUzRCUyMmNvbmZpZy5qc29uJTIyJTJDJTIwcmV2aXNpb24lM0QlMjI4NzdiODRhOGY5M2YyZDYxOWZhYTJhNmU1MTRhMzJiZWVmODhhYjBhJTIyKQ==",highlighted:`<span class="hljs-comment"># \`v1.0\` 태그에서 다운로드하기</span>
<span class="hljs-meta">&gt;&gt;&gt; </span>hf_hub_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, filename=<span class="hljs-string">&quot;config.json&quot;</span>, revision=<span class="hljs-string">&quot;v1.0&quot;</span>)

<span class="hljs-comment"># \`test-branch\` 브랜치에서 다운로드하기</span>
<span class="hljs-meta">&gt;&gt;&gt; </span>hf_hub_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, filename=<span class="hljs-string">&quot;config.json&quot;</span>, revision=<span class="hljs-string">&quot;test-branch&quot;</span>)

<span class="hljs-comment"># PR #3에서 다운로드하기</span>
<span class="hljs-meta">&gt;&gt;&gt; </span>hf_hub_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, filename=<span class="hljs-string">&quot;config.json&quot;</span>, revision=<span class="hljs-string">&quot;refs/pr/3&quot;</span>)

<span class="hljs-comment"># 특정 커밋 해시에서 다운로드하기</span>
<span class="hljs-meta">&gt;&gt;&gt; </span>hf_hub_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, filename=<span class="hljs-string">&quot;config.json&quot;</span>, revision=<span class="hljs-string">&quot;877b84a8f93f2d619faa2a6e514a32beef88ab0a&quot;</span>)`,wrap:!1}}),L=new $({props:{title:"다운로드 URL 만들기",local:"construct-a-download-url",headingTag:"h3"}}),G=new $({props:{title:"전체 리포지토리 다운로드하기",local:"download-an-entire-repository",headingTag:"h2"}}),X=new u({props:{code:"ZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHNuYXBzaG90X2Rvd25sb2FkJTBBc25hcHNob3RfZG93bmxvYWQocmVwb19pZCUzRCUyMmx5c2FuZHJlJTJGYXJ4aXYtbmxwJTIyKSUwQSUwQXNuYXBzaG90X2Rvd25sb2FkKHJlcG9faWQlM0QlMjJnb29nbGUlMkZmbGV1cnMlMjIlMkMlMjByZXBvX3R5cGUlM0QlMjJkYXRhc2V0JTIyKQ==",highlighted:`<span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> snapshot_download
<span class="hljs-meta">&gt;&gt;&gt; </span>snapshot_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>)
<span class="hljs-string">&#x27;/home/lysandre/.cache/huggingface/hub/models--lysandre--arxiv-nlp/snapshots/894a9adde21d9a3e3843e6d5aeaaf01875c7fade&#x27;</span>

<span class="hljs-comment"># 또는 데이터세트의 경우</span>
<span class="hljs-meta">&gt;&gt;&gt; </span>snapshot_download(repo_id=<span class="hljs-string">&quot;google/fleurs&quot;</span>, repo_type=<span class="hljs-string">&quot;dataset&quot;</span>)
<span class="hljs-string">&#x27;/home/lysandre/.cache/huggingface/hub/datasets--google--fleurs/snapshots/199e4ae37915137c555b1765c01477c216287d34&#x27;</span>`,wrap:!1}}),W=new u({props:{code:"ZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHNuYXBzaG90X2Rvd25sb2FkJTBBc25hcHNob3RfZG93bmxvYWQocmVwb19pZCUzRCUyMmx5c2FuZHJlJTJGYXJ4aXYtbmxwJTIyJTJDJTIwcmV2aXNpb24lM0QlMjJyZWZzJTJGcHIlMkYxJTIyKQ==",highlighted:`<span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> snapshot_download
<span class="hljs-meta">&gt;&gt;&gt; </span>snapshot_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, revision=<span class="hljs-string">&quot;refs/pr/1&quot;</span>)`,wrap:!1}}),Q=new $({props:{title:"다운로드할 파일 선택하기",local:"filter-files-to-download",headingTag:"h3"}}),P=new u({props:{code:"ZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHNuYXBzaG90X2Rvd25sb2FkJTBBc25hcHNob3RfZG93bmxvYWQocmVwb19pZCUzRCUyMmx5c2FuZHJlJTJGYXJ4aXYtbmxwJTIyJTJDJTIwYWxsb3dfcGF0dGVybnMlM0QlMjIqLmpzb24lMjIp",highlighted:`<span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> snapshot_download
<span class="hljs-meta">&gt;&gt;&gt; </span>snapshot_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, allow_patterns=<span class="hljs-string">&quot;*.json&quot;</span>)`,wrap:!1}}),S=new u({props:{code:"ZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHNuYXBzaG90X2Rvd25sb2FkJTBBc25hcHNob3RfZG93bmxvYWQocmVwb19pZCUzRCUyMmx5c2FuZHJlJTJGYXJ4aXYtbmxwJTIyJTJDJTIwaWdub3JlX3BhdHRlcm5zJTNEJTVCJTIyKi5tc2dwYWNrJTIyJTJDJTIwJTIyKi5oNSUyMiU1RCk=",highlighted:`<span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> snapshot_download
<span class="hljs-meta">&gt;&gt;&gt; </span>snapshot_download(repo_id=<span class="hljs-string">&quot;lysandre/arxiv-nlp&quot;</span>, ignore_patterns=[<span class="hljs-string">&quot;*.msgpack&quot;</span>, <span class="hljs-string">&quot;*.h5&quot;</span>])`,wrap:!1}}),K=new u({props:{code:"ZnJvbSUyMGh1Z2dpbmdmYWNlX2h1YiUyMGltcG9ydCUyMHNuYXBzaG90X2Rvd25sb2FkJTBBc25hcHNob3RfZG93bmxvYWQocmVwb19pZCUzRCUyMmdwdDIlMjIlMkMlMjBhbGxvd19wYXR0ZXJucyUzRCU1QiUyMioubWQlMjIlMkMlMjAlMjIqLmpzb24lMjIlNUQlMkMlMjBpZ25vcmVfcGF0dGVybnMlM0QlMjJ2b2NhYi5qc29uJTIyKQ==",highlighted:`<span class="hljs-meta">&gt;&gt;&gt; </span><span class="hljs-keyword">from</span> huggingface_hub <span class="hljs-keyword">import</span> snapshot_download
<span class="hljs-meta">&gt;&gt;&gt; </span>snapshot_download(repo_id=<span class="hljs-string">&quot;gpt2&quot;</span>, allow_patterns=[<span class="hljs-string">&quot;*.md&quot;</span>, <span class="hljs-string">&quot;*.json&quot;</span>], ignore_patterns=<span class="hljs-string">&quot;vocab.json&quot;</span>)`,wrap:!1}}),E=new $({props:{title:"로컬 폴더에 파일 다운로드하기",local:"download-files-to-local-folder",headingTag:"h2"}}),st=new $({props:{title:"CLI에서 파일 다운로드하기",local:"download-from-the-cli",headingTag:"h2"}}),at=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBncHQyJTIwY29uZmlnLmpzb24=",highlighted:`&gt;&gt;&gt; huggingface-cli download gpt2 config.json
/home/wauplin/.cache/huggingface/hub/models--gpt2/snapshots/11c5a3d5811f50298f278a704980280950aedb10/config.json`,wrap:!1}}),it=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBncHQyJTIwY29uZmlnLmpzb24lMjAtLXRva2VuJTNEaGZfKioqKg==",highlighted:`&gt;&gt;&gt; huggingface-cli download gpt2 config.json --token=hf_****
/home/wauplin/.cache/huggingface/hub/models--gpt2/snapshots/11c5a3d5811f50298f278a704980280950aedb10/config.json`,wrap:!1}}),dt=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBncHQyJTIwY29uZmlnLmpzb24lMjBtb2RlbC5zYWZldGVuc29ycw==",highlighted:`&gt;&gt;&gt; huggingface-cli download gpt2 config.json model.safetensors
Fetching 2 files: 100%|████████████████████████████████████████████| 2/2 [00:00&lt;00:00, 23831.27it/s]
/home/wauplin/.cache/huggingface/hub/models--gpt2/snapshots/11c5a3d5811f50298f278a704980280950aedb10`,wrap:!1}}),mt=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBncHQyJTIwY29uZmlnLmpzb24lMjBtb2RlbC5zYWZldGVuc29ycw==",highlighted:`&gt;&gt;&gt; huggingface-cli download gpt2 config.json model.safetensors
/home/wauplin/.cache/huggingface/hub/models--gpt2/snapshots/11c5a3d5811f50298f278a704980280950aedb10`,wrap:!1}}),rt=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBncHQyJTIwY29uZmlnLmpzb24lMjAtLWNhY2hlLWRpciUzRC4lMkZjYWNoZQ==",highlighted:`&gt;&gt;&gt; huggingface-cli download gpt2 config.json --cache-dir=./cache
./cache/models--gpt2/snapshots/11c5a3d5811f50298f278a704980280950aedb10/config.json`,wrap:!1}}),ht=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBncHQyJTIwY29uZmlnLmpzb24lMjAtLWxvY2FsLWRpciUzRC4lMkZtb2RlbHMlMkZncHQy",highlighted:`&gt;&gt;&gt; huggingface-cli download gpt2 config.json --local-dir=./models/gpt2
./models/gpt2/config.json`,wrap:!1}}),bt=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjBiaWdjb2RlJTJGdGhlLXN0YWNrJTIwLS1yZXBvLXR5cGUlM0RkYXRhc2V0JTIwLS1yZXZpc2lvbiUzRHYxLjIlMjAtLWluY2x1ZGUlM0QlMjJkYXRhJTJGcHl0aG9uJTJGKiUyMiUyMC0tZXhjbHU=",highlighted:`&gt;&gt;&gt; huggingface-cli download bigcode/the-stack --repo-type=dataset --revision=v1.2 --include=<span class="hljs-string">&quot;data/python/*&quot;</span> --exclu
de=<span class="hljs-string">&quot;*.json&quot;</span> --exclude=<span class="hljs-string">&quot;*.zip&quot;</span>
Fetching 206 files:   100%|████████████████████████████████████████████| 206/206 [02:31&lt;2:31, ?it/s]
/home/wauplin/.cache/huggingface/hub/datasets--bigcode--the-stack/snapshots/9ca8fa6acdbc8ce920a0cb58adcdafc495818ae7`,wrap:!1}}),Mt=new u({props:{code:"aHVnZ2luZ2ZhY2UtY2xpJTIwZG93bmxvYWQlMjAtLWhlbHA=",highlighted:'huggingface-cli download --<span class="hljs-built_in">help</span>',wrap:!1}}),wt=new gl({props:{source:"https://github.com/huggingface/huggingface_hub/blob/main/docs/source/ko/guides/download.md"}}),{c(){h=o("meta"),w=n(),b=o("p"),_t=n(),d(_.$$.fragment),Tt=n(),y=o("p"),y.innerHTML=Je,vt=n(),j=o("ul"),j.innerHTML=Ze,Jt=n(),d(T.$$.fragment),Zt=n(),v=o("p"),v.innerHTML=He,Ht=n(),d(M.$$.fragment),xt=n(),d(J.$$.fragment),Yt=n(),Z=o("p"),Z.innerHTML=xe,Ut=n(),d(H.$$.fragment),qt=n(),d(x.$$.fragment),Lt=n(),Y=o("p"),Y.innerHTML=Ye,kt=n(),d(U.$$.fragment),Gt=n(),q=o("p"),q.innerHTML=Ue,Ct=n(),d(L.$$.fragment),It=n(),k=o("p"),k.innerHTML=qe,Xt=n(),d(G.$$.fragment),Rt=n(),C=o("p"),C.innerHTML=Le,Wt=n(),I=o("p"),I.innerHTML=ke,Qt=n(),d(X.$$.fragment),Bt=n(),R=o("p"),R.innerHTML=Ge,zt=n(),d(W.$$.fragment),Nt=n(),d(Q.$$.fragment),Pt=n(),B=o("p"),B.innerHTML=Ce,Vt=n(),z=o("p"),z.innerHTML=Ie,St=n(),N=o("p"),N.innerHTML=Xe,Ft=n(),d(P.$$.fragment),Kt=n(),V=o("p"),V.innerHTML=Re,Et=n(),d(S.$$.fragment),At=n(),F=o("p"),F.innerHTML=We,Dt=n(),d(K.$$.fragment),Ot=n(),d(E.$$.fragment),te=n(),A=o("p"),A.innerHTML=Qe,ee=n(),D=o("p"),D.innerHTML=Be,le=n(),O=o("ul"),O.innerHTML=ze,se=n(),tt=o("p"),tt.textContent=Ne,ne=n(),et=o("table"),et.innerHTML=Pe,ae=n(),lt=o("p"),lt.innerHTML=Ve,oe=n(),d(st.$$.fragment),ie=n(),nt=o("p"),nt.innerHTML=Se,pe=n(),d(at.$$.fragment),de=n(),ot=o("p"),ot.innerHTML=Fe,ce=n(),d(it.$$.fragment),me=n(),pt=o("p"),pt.textContent=Ke,ge=n(),d(dt.$$.fragment),re=n(),ct=o("p"),ct.innerHTML=Ee,fe=n(),d(mt.$$.fragment),he=n(),gt=o("p"),gt.innerHTML=Ae,ue=n(),d(rt.$$.fragment),be=n(),ft=o("p"),ft.innerHTML=De,$e=n(),d(ht.$$.fragment),Me=n(),ut=o("p"),ut.textContent=Oe,we=n(),d(bt.$$.fragment),_e=n(),$t=o("p"),$t.textContent=tl,ye=n(),d(Mt.$$.fragment),je=n(),d(wt.$$.fragment),Te=n(),yt=o("p"),this.h()},l(t){const e=dl("svelte-u9bgzb",document.head);h=i(e,"META",{name:!0,content:!0}),e.forEach(l),w=a(t),b=i(t,"P",{}),ll(b).forEach(l),_t=a(t),c(_.$$.fragment,t),Tt=a(t),y=i(t,"P",{"data-svelte-h":!0}),p(y)!=="svelte-12yzo3k"&&(y.innerHTML=Je),vt=a(t),j=i(t,"UL",{"data-svelte-h":!0}),p(j)!=="svelte-9lvjcz"&&(j.innerHTML=Ze),Jt=a(t),c(T.$$.fragment,t),Zt=a(t),v=i(t,"P",{"data-svelte-h":!0}),p(v)!=="svelte-1tx5ybc"&&(v.innerHTML=He),Ht=a(t),c(M.$$.fragment,t),xt=a(t),c(J.$$.fragment,t),Yt=a(t),Z=i(t,"P",{"data-svelte-h":!0}),p(Z)!=="svelte-5wyw13"&&(Z.innerHTML=xe),Ut=a(t),c(H.$$.fragment,t),qt=a(t),c(x.$$.fragment,t),Lt=a(t),Y=i(t,"P",{"data-svelte-h":!0}),p(Y)!=="svelte-1s99woe"&&(Y.innerHTML=Ye),kt=a(t),c(U.$$.fragment,t),Gt=a(t),q=i(t,"P",{"data-svelte-h":!0}),p(q)!=="svelte-trafs7"&&(q.innerHTML=Ue),Ct=a(t),c(L.$$.fragment,t),It=a(t),k=i(t,"P",{"data-svelte-h":!0}),p(k)!=="svelte-5pjxqr"&&(k.innerHTML=qe),Xt=a(t),c(G.$$.fragment,t),Rt=a(t),C=i(t,"P",{"data-svelte-h":!0}),p(C)!=="svelte-n4vzdl"&&(C.innerHTML=Le),Wt=a(t),I=i(t,"P",{"data-svelte-h":!0}),p(I)!=="svelte-1f3sa6m"&&(I.innerHTML=ke),Qt=a(t),c(X.$$.fragment,t),Bt=a(t),R=i(t,"P",{"data-svelte-h":!0}),p(R)!=="svelte-hbpu8u"&&(R.innerHTML=Ge),zt=a(t),c(W.$$.fragment,t),Nt=a(t),c(Q.$$.fragment,t),Pt=a(t),B=i(t,"P",{"data-svelte-h":!0}),p(B)!=="svelte-xvbijz"&&(B.innerHTML=Ce),Vt=a(t),z=i(t,"P",{"data-svelte-h":!0}),p(z)!=="svelte-chrf7p"&&(z.innerHTML=Ie),St=a(t),N=i(t,"P",{"data-svelte-h":!0}),p(N)!=="svelte-1i6nc32"&&(N.innerHTML=Xe),Ft=a(t),c(P.$$.fragment,t),Kt=a(t),V=i(t,"P",{"data-svelte-h":!0}),p(V)!=="svelte-pbcfo6"&&(V.innerHTML=Re),Et=a(t),c(S.$$.fragment,t),At=a(t),F=i(t,"P",{"data-svelte-h":!0}),p(F)!=="svelte-aaekik"&&(F.innerHTML=We),Dt=a(t),c(K.$$.fragment,t),Ot=a(t),c(E.$$.fragment,t),te=a(t),A=i(t,"P",{"data-svelte-h":!0}),p(A)!=="svelte-13bhnj9"&&(A.innerHTML=Qe),ee=a(t),D=i(t,"P",{"data-svelte-h":!0}),p(D)!=="svelte-1gyitou"&&(D.innerHTML=Be),le=a(t),O=i(t,"UL",{"data-svelte-h":!0}),p(O)!=="svelte-1x40m8a"&&(O.innerHTML=ze),se=a(t),tt=i(t,"P",{"data-svelte-h":!0}),p(tt)!=="svelte-1alyupr"&&(tt.textContent=Ne),ne=a(t),et=i(t,"TABLE",{"data-svelte-h":!0}),p(et)!=="svelte-gc9vj1"&&(et.innerHTML=Pe),ae=a(t),lt=i(t,"P",{"data-svelte-h":!0}),p(lt)!=="svelte-176b1gi"&&(lt.innerHTML=Ve),oe=a(t),c(st.$$.fragment,t),ie=a(t),nt=i(t,"P",{"data-svelte-h":!0}),p(nt)!=="svelte-1tjryy7"&&(nt.innerHTML=Se),pe=a(t),c(at.$$.fragment,t),de=a(t),ot=i(t,"P",{"data-svelte-h":!0}),p(ot)!=="svelte-gs7r9j"&&(ot.innerHTML=Fe),ce=a(t),c(it.$$.fragment,t),me=a(t),pt=i(t,"P",{"data-svelte-h":!0}),p(pt)!=="svelte-10dyi3t"&&(pt.textContent=Ke),ge=a(t),c(dt.$$.fragment,t),re=a(t),ct=i(t,"P",{"data-svelte-h":!0}),p(ct)!=="svelte-13775v0"&&(ct.innerHTML=Ee),fe=a(t),c(mt.$$.fragment,t),he=a(t),gt=i(t,"P",{"data-svelte-h":!0}),p(gt)!=="svelte-171dpxr"&&(gt.innerHTML=Ae),ue=a(t),c(rt.$$.fragment,t),be=a(t),ft=i(t,"P",{"data-svelte-h":!0}),p(ft)!=="svelte-otwmir"&&(ft.innerHTML=De),$e=a(t),c(ht.$$.fragment,t),Me=a(t),ut=i(t,"P",{"data-svelte-h":!0}),p(ut)!=="svelte-1e7xiy8"&&(ut.textContent=Oe),we=a(t),c(bt.$$.fragment,t),_e=a(t),$t=i(t,"P",{"data-svelte-h":!0}),p($t)!=="svelte-ste4pn"&&($t.textContent=tl),ye=a(t),c(Mt.$$.fragment,t),je=a(t),c(wt.$$.fragment,t),Te=a(t),yt=i(t,"P",{}),ll(yt).forEach(l),this.h()},h(){sl(h,"name","hf:doc:metadata"),sl(h,"content",hl)},m(t,e){cl(document.head,h),s(t,w,e),s(t,b,e),s(t,_t,e),m(_,t,e),s(t,Tt,e),s(t,y,e),s(t,vt,e),s(t,j,e),s(t,Jt,e),m(T,t,e),s(t,Zt,e),s(t,v,e),s(t,Ht,e),m(M,t,e),s(t,xt,e),m(J,t,e),s(t,Yt,e),s(t,Z,e),s(t,Ut,e),m(H,t,e),s(t,qt,e),m(x,t,e),s(t,Lt,e),s(t,Y,e),s(t,kt,e),m(U,t,e),s(t,Gt,e),s(t,q,e),s(t,Ct,e),m(L,t,e),s(t,It,e),s(t,k,e),s(t,Xt,e),m(G,t,e),s(t,Rt,e),s(t,C,e),s(t,Wt,e),s(t,I,e),s(t,Qt,e),m(X,t,e),s(t,Bt,e),s(t,R,e),s(t,zt,e),m(W,t,e),s(t,Nt,e),m(Q,t,e),s(t,Pt,e),s(t,B,e),s(t,Vt,e),s(t,z,e),s(t,St,e),s(t,N,e),s(t,Ft,e),m(P,t,e),s(t,Kt,e),s(t,V,e),s(t,Et,e),m(S,t,e),s(t,At,e),s(t,F,e),s(t,Dt,e),m(K,t,e),s(t,Ot,e),m(E,t,e),s(t,te,e),s(t,A,e),s(t,ee,e),s(t,D,e),s(t,le,e),s(t,O,e),s(t,se,e),s(t,tt,e),s(t,ne,e),s(t,et,e),s(t,ae,e),s(t,lt,e),s(t,oe,e),m(st,t,e),s(t,ie,e),s(t,nt,e),s(t,pe,e),m(at,t,e),s(t,de,e),s(t,ot,e),s(t,ce,e),m(it,t,e),s(t,me,e),s(t,pt,e),s(t,ge,e),m(dt,t,e),s(t,re,e),s(t,ct,e),s(t,fe,e),m(mt,t,e),s(t,he,e),s(t,gt,e),s(t,ue,e),m(rt,t,e),s(t,be,e),s(t,ft,e),s(t,$e,e),m(ht,t,e),s(t,Me,e),s(t,ut,e),s(t,we,e),m(bt,t,e),s(t,_e,e),s(t,$t,e),s(t,ye,e),m(Mt,t,e),s(t,je,e),m(wt,t,e),s(t,Te,e),s(t,yt,e),ve=!0},p(t,[e]){const el={};e&2&&(el.$$scope={dirty:e,ctx:t}),M.$set(el)},i(t){ve||(g(_.$$.fragment,t),g(T.$$.fragment,t),g(M.$$.fragment,t),g(J.$$.fragment,t),g(H.$$.fragment,t),g(x.$$.fragment,t),g(U.$$.fragment,t),g(L.$$.fragment,t),g(G.$$.fragment,t),g(X.$$.fragment,t),g(W.$$.fragment,t),g(Q.$$.fragment,t),g(P.$$.fragment,t),g(S.$$.fragment,t),g(K.$$.fragment,t),g(E.$$.fragment,t),g(st.$$.fragment,t),g(at.$$.fragment,t),g(it.$$.fragment,t),g(dt.$$.fragment,t),g(mt.$$.fragment,t),g(rt.$$.fragment,t),g(ht.$$.fragment,t),g(bt.$$.fragment,t),g(Mt.$$.fragment,t),g(wt.$$.fragment,t),ve=!0)},o(t){r(_.$$.fragment,t),r(T.$$.fragment,t),r(M.$$.fragment,t),r(J.$$.fragment,t),r(H.$$.fragment,t),r(x.$$.fragment,t),r(U.$$.fragment,t),r(L.$$.fragment,t),r(G.$$.fragment,t),r(X.$$.fragment,t),r(W.$$.fragment,t),r(Q.$$.fragment,t),r(P.$$.fragment,t),r(S.$$.fragment,t),r(K.$$.fragment,t),r(E.$$.fragment,t),r(st.$$.fragment,t),r(at.$$.fragment,t),r(it.$$.fragment,t),r(dt.$$.fragment,t),r(mt.$$.fragment,t),r(rt.$$.fragment,t),r(ht.$$.fragment,t),r(bt.$$.fragment,t),r(Mt.$$.fragment,t),r(wt.$$.fragment,t),ve=!1},d(t){t&&(l(w),l(b),l(_t),l(Tt),l(y),l(vt),l(j),l(Jt),l(Zt),l(v),l(Ht),l(xt),l(Yt),l(Z),l(Ut),l(qt),l(Lt),l(Y),l(kt),l(Gt),l(q),l(Ct),l(It),l(k),l(Xt),l(Rt),l(C),l(Wt),l(I),l(Qt),l(Bt),l(R),l(zt),l(Nt),l(Pt),l(B),l(Vt),l(z),l(St),l(N),l(Ft),l(Kt),l(V),l(Et),l(At),l(F),l(Dt),l(Ot),l(te),l(A),l(ee),l(D),l(le),l(O),l(se),l(tt),l(ne),l(et),l(ae),l(lt),l(oe),l(ie),l(nt),l(pe),l(de),l(ot),l(ce),l(me),l(pt),l(ge),l(re),l(ct),l(fe),l(he),l(gt),l(ue),l(be),l(ft),l($e),l(Me),l(ut),l(we),l(_e),l($t),l(ye),l(je),l(Te),l(yt)),l(h),f(_,t),f(T,t),f(M,t),f(J,t),f(H,t),f(x,t),f(U,t),f(L,t),f(G,t),f(X,t),f(W,t),f(Q,t),f(P,t),f(S,t),f(K,t),f(E,t),f(st,t),f(at,t),f(it,t),f(dt,t),f(mt,t),f(rt,t),f(ht,t),f(bt,t),f(Mt,t),f(wt,t)}}}const hl='{"title":"Hub에서 파일 다운로드하기","local":"download-files-from-the-hub","sections":[{"title":"파일 하나만 다운로드하기","local":"download-a-single-file","sections":[{"title":"최신 버전에서 파일 다운로드하기","local":"from-latest-version","sections":[],"depth":3},{"title":"특정 버전에서 파일 다운로드하기","local":"from-specific-version","sections":[],"depth":3},{"title":"다운로드 URL 만들기","local":"construct-a-download-url","sections":[],"depth":3}],"depth":2},{"title":"전체 리포지토리 다운로드하기","local":"download-an-entire-repository","sections":[{"title":"다운로드할 파일 선택하기","local":"filter-files-to-download","sections":[],"depth":3}],"depth":2},{"title":"로컬 폴더에 파일 다운로드하기","local":"download-files-to-local-folder","sections":[],"depth":2},{"title":"CLI에서 파일 다운로드하기","local":"download-from-the-cli","sections":[],"depth":2}],"depth":1}';function ul(jt){return al(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class yl extends il{constructor(h){super(),pl(this,h,ul,fl,nl,{})}}export{yl as component};
