course/pr_1114/ko/_app/immutable/nodes/2.02f14c8b.js

import{s as Lt,n as jt,o as Ht}from"../chunks/scheduler.505acc25.js";import{S as Jt,i as kt,e as p,s,c as f,h as Pt,a,d as l,b as i,f as _t,g as $,j as m,k as Oe,l as Ut,m as n,n as r,t as o,o as u,p as v}from"../chunks/index.821724d0.js";import{C as Gt,H as Ke,E as Zt}from"../chunks/MermaidChart.svelte_svelte_type_style_lang.59f4cdb8.js";import{C as c}from"../chunks/CodeBlock.2a5b6afa.js";function Wt(et){let h,ae,ie,me,d,fe,C,$e,M,tt='Hugging Face 강의에 오신 여러분들 환영합니다! 이번 강의 소개에서는 작업 환경 설정에 대해 안내드리겠습니다. 방금 막 이번 과정을 시작하셨다면 먼저 <a href="/course/chapter1">Chapter 1</a> 내용을 살펴보고 돌아오신 뒤, 환경을 설정하여 코드를 직접 실행해보시길 추천드립니다.',re,g,lt="이번 과정에서 사용할 모든 라이브러리는 파이썬 패키지를 통해 사용할 수 있으므로 여기서는 파이썬 환경 설정 방법 및 필요한 라이브러리 설치 방법을 보여드리겠습니다.",oe,T,nt="작업 환경 설정 방법으로 Colab 노트북을 이용한 방법과 파이썬 가상 환경을 이용한 방법, 두 가지를 다룰 것이고 둘 중 더 마음이 가는 방식을 자유롭게 선택하셔도 됩니다. 입문자의 경우 Colab 노트북을 이용하시길 강력하게 추천합니다.",ue,x,st="여기서 Windows 환경에 대해서는 다루지 않기 때문에 Windows에서 실행 중이시면 Colab 노트북을 이용해 아래 과정을 따라가 주시길 권장드립니다. Linux 혹은 macOS를 실행 중이시라면 어떤 방식을 택해도 무방합니다.",ve,y,it='대부분의 강의는 여러분이 Hugging Face 계정이 있다는 것을 전제로 하기 때문에 지금 바로 계정을 생성하시길 추천드립니다: <a href="https://huggingface.co/join" rel="nofollow">계정 생성하기</a>',ce,_,he,L,pt="Colab 노트북은 가장 쉬운 설정 방식입니다. 브라우저에 Colab 노트북을 켜고 바로 코딩을 시작하시면 됩니다!",we,j,at='Colab에 익숙하지 않으시다면 <a href="https://colab.research.google.com/notebooks/intro.ipynb" rel="nofollow">introduction</a> 링크를 따라 시작하시길 권장드립니다. Colab에서는 GPU, TPU와 같은 가속 하드웨어를 사용할 수 있으며 적은 양의 워크로드에 대해서는 무료입니다.',be,H,mt="Colab과 친숙해 지셨다면 새로운 노트북을 생성하여 아래와 같이 시작합니다:",de,w,ft='<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>',Ce,J,$t="다음으로, 이번 강의에서 사용할 라이브러리를 설치합니다. 설치에는 파이썬 패키지 관리자인 <code>pip</code> 를 사용하도록 하겠습니다. 노트북 파일에서는 시스템 명령어 앞에 <code>!</code> 를 붙여 실행시킬 수 있으므로, 아래와 같이 🤗 Transformers 라이브러리를 설치할 수 있습니다:",Me,k,ge,P,rt="이제 파이썬 런타임에 패키지를 가져와 패키지가 제대로 설치되었는지 확인해보겠습니다:",Te,U,xe,b,ot='<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/install.gif" alt="A gif showing the result of the two commands above: installation and import" width="80%"/>',ye,G,ut="위의 방식으로는 아주 가벼운 버전의 🤗 Transformers가 설치되고, 이는 PyTorch나 TensorFlow와 같은 특정 기계학습 프레임워크를 포함하지 않습니다. 하지만 본 강의에서는 이 라이브러리의 아주 다양한 기능들을 사용할 예정이므로, 아래의 명령어를 통해 대부분의 예제에 필요한 종속성(dependency)을 제공하는 개발 버전을 설치하시길 바랍니다:",_e,Z,Le,W,vt="설치에 시간이 조금 걸리지만 곧 강의를 위한 준비가 모두 끝납니다!",je,I,He,z,ct='파이썬 가상 환경 사용을 원하신다면 먼저 파이썬을 설치해야 합니다. 이 <a href="https://realpython.com/installing-python/" rel="nofollow">가이드</a>를 따라 설치를 진행하실 수 있습니다.',Je,B,ht="파이썬 설치가 완료되면 터미널에서 파이썬 명령어를 실행할 수 있습니다. 다음 단계로 넘어가기 전에, 다음과 같은 명령어를 실행하여 설치가 잘 되었는지 확인하세요: <code>python --version</code>. 이 때 시스템에 사용할 수 있는 파이썬 버전을 출력되어야 합니다.",ke,V,wt="터미널에서 <code>python --version</code> 과 같은 파이썬 명령어를 실행하면, 명령어를 실행하는 프로그램을 시스템의 “메인(main)” 파이썬으로 생각해야 합니다. 이 메인 파이썬은 어떤 패키지도 설치하지 않은 상태로 유지하면서, 작업 중인 각 어플리케이션마다 별도의 환경을 생성하여 이용하는 것을 권장합니다. 이렇게 하면, 각 어플리케이션은 각각의 의존성 및 패키지를 갖게 되어 다른 어플리케이션과의 잠재적 호환성 문제를 피할 수 있습니다.",Pe,X,bt='파이썬에서 이는 <a href="https://docs.python.org/3/tutorial/venv.html" rel="nofollow"><em>가상 환경</em></a>을 통해 완수됩니다. 가상 환경은 자체 포함 디렉토리 트리로, 각 트리는 어플리케이션에게 필요한 모든 패키지와 함께 특정 파이썬 버전에 대한 파이썬 설치를 포함합니다. 이러한 가상 환경을 생성하는 방법은 여러 툴을 통해 할 수 있지만, 여기서는 공식 파이썬 패키지인 <code>[venv](https://docs.python.org/3/library/venv.html#module-venv)</code> 를 통해 생성해 보겠습니다.',Ue,E,dt="먼저, 어플리케이션을 넣어줄 디렉토리를 생성합니다. 예를 들어, 홈 디렉토리의 <em>transformers-course</em>와 같은 이름의 디렉토리를 만들어 봅시다:",Ge,R,Ze,N,Ct="디렉토리 내부에서, 파이썬 <code>venv</code> 모듈을 사용하여 가상 환경을 생성합니다:",We,F,Ie,Y,Mt="원래 아무것도 없던 빈 폴더에 <em>.env</em>라는 디렉토리가 생기게 됩니다:",ze,Q,Be,S,Ve,A,gt="<code>activate</code> 스크립트를 통해 가상 환경으로 접속할 수 있고, <code>deactivate</code> 를 통해 가상 환경 밖으로 나올 수 있습니다:",Xe,q,Ee,D,Tt="환경이 제대로 활성화 되었는지 <code>which python</code> 명령어를 실행하여 확인해 봅시다. 아래와 같이 가상 환경을 보여준다면 제대로 활성화가 것입니다!",Re,O,Ne,K,Fe,ee,Ye,te,xt="Google Colab 사용법에서와 마찬가지로 다음 단계로 넘어가기 위해 패키지를 설치해야 합니다. 여기서도, <code>pip</code> 패키지 관리자를 통해  🤗 Transformers 개발 버전을 설치할 수 있습니다:",Qe,le,Se,ne,yt="이제 모든 환경 설정을 마치고 시작할 준비가 되었습니다!",Ae,se,qe,pe,De;return d=new Gt({props:{containerStyle:"float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"}}),C=new Ke({props:{title:"강의 소개",local:"강의-소개",headingTag:"h1"}}),_=new Ke({props:{title:"Google Colab 노트북 사용하기",local:"google-colab-노트북-사용하기",headingTag:"h2"}}),k=new c({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnM=",highlighted:'!pip <span class="hljs-keyword">install</span> transformers',wrap:!1}}),U=new c({props:{code:"aW1wb3J0JTIwdHJhbnNmb3JtZXJz",highlighted:'<span class="hljs-keyword">import</span> transformers',wrap:!1}}),Z=new c({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnMlNUJzZW50ZW5jZXBpZWNlJTVE",highlighted:'!pip <span class="hljs-keyword">install</span> transformers[sentencepiece]',wrap:!1}}),I=new Ke({props:{title:"파이썬 가상 환경 사용하기",local:"파이썬-가상-환경-사용하기",headingTag:"h2"}}),R=new c({props:{code:"bWtkaXIlMjB+JTJGdHJhbnNmb3JtZXJzLWNvdXJzZSUwQWNkJTIwfiUyRnRyYW5zZm9ybWVycy1jb3Vyc2U=",highlighted:`<span class="hljs-built_in">mkdir</span> ~/transformers-course
<span class="hljs-built_in">cd</span> ~/transformers-course`,wrap:!1}}),F=new c({props:{code:"cHl0aG9uJTIwLW0lMjB2ZW52JTIwLmVudg==",highlighted:'<span class="hljs-keyword">python</span> -m venv .<span class="hljs-keyword">env</span>',wrap:!1}}),Q=new c({props:{code:"bHMlMjAtYQ==",highlighted:'<span class="hljs-built_in">ls</span> -a',wrap:!1}}),S=new c({props:{code:"LiUyMCUyMCUyMCUyMCUyMCUyMC4uJTIwJTIwJTIwJTIwLmVudg==",highlighted:'.      <span class="hljs-string">..</span>    <span class="hljs-string">.env</span>',wrap:!1}}),q=new c({props:{code:"JTIzJTIwQWN0aXZhdGUlMjB0aGUlMjB2aXJ0dWFsJTIwZW52aXJvbm1lbnQlMEFzb3VyY2UlMjAuZW52JTJGYmluJTJGYWN0aXZhdGUlMEElMEElMjMlMjBEZWFjdGl2YXRlJTIwdGhlJTIwdmlydHVhbCUyMGVudmlyb25tZW50JTBBZGVhY3RpdmF0ZQ==",highlighted:`<span class="hljs-comment"># Activate the virtual environment</span>
<span class="hljs-built_in">source</span> .<span class="hljs-built_in">env</span>/bin/activate

<span class="hljs-comment"># Deactivate the virtual environment</span>
deactivate`,wrap:!1}}),O=new c({props:{code:"d2hpY2glMjBweXRob24=",highlighted:'<span class="hljs-built_in">which</span> python',wrap:!1}}),K=new c({props:{code:"JTJGaG9tZSUyRiUzQ3VzZXIlM0UlMkZ0cmFuc2Zvcm1lcnMtY291cnNlJTJGLmVudiUyRmJpbiUyRnB5dGhvbg==",highlighted:'<span class="hljs-regexp">/home/</span>&lt;user&gt;<span class="hljs-regexp">/transformers-course/</span>.env<span class="hljs-regexp">/bin/</span>python',wrap:!1}}),ee=new Ke({props:{title:"의존성(dependencies) 설치하기",local:"의존성dependencies-설치하기",headingTag:"h3"}}),le=new c({props:{code:"cGlwJTIwaW5zdGFsbCUyMCUyMnRyYW5zZm9ybWVycyU1QnNlbnRlbmNlcGllY2UlNUQlMjI=",highlighted:'pip <span class="hljs-keyword">install</span> <span class="hljs-string">&quot;transformers[sentencepiece]&quot;</span>',wrap:!1}}),se=new Zt({props:{source:"https://github.com/huggingface/course/blob/main/chapters/ko/chapter0/1.mdx"}}),{c(){h=p("meta"),ae=s(),ie=p("p"),me=s(),f(d.$$.fragment),fe=s(),f(C.$$.fragment),$e=s(),M=p("p"),M.innerHTML=tt,re=s(),g=p("p"),g.textContent=lt,oe=s(),T=p("p"),T.textContent=nt,ue=s(),x=p("p"),x.textContent=st,ve=s(),y=p("p"),y.innerHTML=it,ce=s(),f(_.$$.fragment),he=s(),L=p("p"),L.textContent=pt,we=s(),j=p("p"),j.innerHTML=at,be=s(),H=p("p"),H.textContent=mt,de=s(),w=p("div"),w.innerHTML=ft,Ce=s(),J=p("p"),J.innerHTML=$t,Me=s(),f(k.$$.fragment),ge=s(),P=p("p"),P.textContent=rt,Te=s(),f(U.$$.fragment),xe=s(),b=p("div"),b.innerHTML=ot,ye=s(),G=p("p"),G.textContent=ut,_e=s(),f(Z.$$.fragment),Le=s(),W=p("p"),W.textContent=vt,je=s(),f(I.$$.fragment),He=s(),z=p("p"),z.innerHTML=ct,Je=s(),B=p("p"),B.innerHTML=ht,ke=s(),V=p("p"),V.innerHTML=wt,Pe=s(),X=p("p"),X.innerHTML=bt,Ue=s(),E=p("p"),E.innerHTML=dt,Ge=s(),f(R.$$.fragment),Ze=s(),N=p("p"),N.innerHTML=Ct,We=s(),f(F.$$.fragment),Ie=s(),Y=p("p"),Y.innerHTML=Mt,ze=s(),f(Q.$$.fragment),Be=s(),f(S.$$.fragment),Ve=s(),A=p("p"),A.innerHTML=gt,Xe=s(),f(q.$$.fragment),Ee=s(),D=p("p"),D.innerHTML=Tt,Re=s(),f(O.$$.fragment),Ne=s(),f(K.$$.fragment),Fe=s(),f(ee.$$.fragment),Ye=s(),te=p("p"),te.innerHTML=xt,Qe=s(),f(le.$$.fragment),Se=s(),ne=p("p"),ne.textContent=yt,Ae=s(),f(se.$$.fragment),qe=s(),pe=p("p"),this.h()},l(e){const t=Pt("svelte-u9bgzb",document.head);h=a(t,"META",{name:!0,content:!0}),t.forEach(l),ae=i(e),ie=a(e,"P",{}),_t(ie).forEach(l),me=i(e),$(d.$$.fragment,e),fe=i(e),$(C.$$.fragment,e),$e=i(e),M=a(e,"P",{"data-svelte-h":!0}),m(M)!=="svelte-8mm6kh"&&(M.innerHTML=tt),re=i(e),g=a(e,"P",{"data-svelte-h":!0}),m(g)!=="svelte-1mlonw8"&&(g.textContent=lt),oe=i(e),T=a(e,"P",{"data-svelte-h":!0}),m(T)!=="svelte-1o0bxy7"&&(T.textContent=nt),ue=i(e),x=a(e,"P",{"data-svelte-h":!0}),m(x)!=="svelte-1vwc2p6"&&(x.textContent=st),ve=i(e),y=a(e,"P",{"data-svelte-h":!0}),m(y)!=="svelte-58bkwz"&&(y.innerHTML=it),ce=i(e),$(_.$$.fragment,e),he=i(e),L=a(e,"P",{"data-svelte-h":!0}),m(L)!=="svelte-kzcti5"&&(L.textContent=pt),we=i(e),j=a(e,"P",{"data-svelte-h":!0}),m(j)!=="svelte-1fn7zqz"&&(j.innerHTML=at),be=i(e),H=a(e,"P",{"data-svelte-h":!0}),m(H)!=="svelte-zeghlw"&&(H.textContent=mt),de=i(e),w=a(e,"DIV",{class:!0,"data-svelte-h":!0}),m(w)!=="svelte-1mpe2rl"&&(w.innerHTML=ft),Ce=i(e),J=a(e,"P",{"data-svelte-h":!0}),m(J)!=="svelte-682d6o"&&(J.innerHTML=$t),Me=i(e),$(k.$$.fragment,e),ge=i(e),P=a(e,"P",{"data-svelte-h":!0}),m(P)!=="svelte-13k6js"&&(P.textContent=rt),Te=i(e),$(U.$$.fragment,e),xe=i(e),b=a(e,"DIV",{class:!0,"data-svelte-h":!0}),m(b)!=="svelte-1cj51wg"&&(b.innerHTML=ot),ye=i(e),G=a(e,"P",{"data-svelte-h":!0}),m(G)!=="svelte-1f65mzk"&&(G.textContent=ut),_e=i(e),$(Z.$$.fragment,e),Le=i(e),W=a(e,"P",{"data-svelte-h":!0}),m(W)!=="svelte-9o5cuf"&&(W.textContent=vt),je=i(e),$(I.$$.fragment,e),He=i(e),z=a(e,"P",{"data-svelte-h":!0}),m(z)!=="svelte-1ala03n"&&(z.innerHTML=ct),Je=i(e),B=a(e,"P",{"data-svelte-h":!0}),m(B)!=="svelte-175door"&&(B.innerHTML=ht),ke=i(e),V=a(e,"P",{"data-svelte-h":!0}),m(V)!=="svelte-kwm5uv"&&(V.innerHTML=wt),Pe=i(e),X=a(e,"P",{"data-svelte-h":!0}),m(X)!=="svelte-cohcrn"&&(X.innerHTML=bt),Ue=i(e),E=a(e,"P",{"data-svelte-h":!0}),m(E)!=="svelte-17sf826"&&(E.innerHTML=dt),Ge=i(e),$(R.$$.fragment,e),Ze=i(e),N=a(e,"P",{"data-svelte-h":!0}),m(N)!=="svelte-d6u3p3"&&(N.innerHTML=Ct),We=i(e),$(F.$$.fragment,e),Ie=i(e),Y=a(e,"P",{"data-svelte-h":!0}),m(Y)!=="svelte-19ufi88"&&(Y.innerHTML=Mt),ze=i(e),$(Q.$$.fragment,e),Be=i(e),$(S.$$.fragment,e),Ve=i(e),A=a(e,"P",{"data-svelte-h":!0}),m(A)!=="svelte-10iyx9f"&&(A.innerHTML=gt),Xe=i(e),$(q.$$.fragment,e),Ee=i(e),D=a(e,"P",{"data-svelte-h":!0}),m(D)!=="svelte-1w7twka"&&(D.innerHTML=Tt),Re=i(e),$(O.$$.fragment,e),Ne=i(e),$(K.$$.fragment,e),Fe=i(e),$(ee.$$.fragment,e),Ye=i(e),te=a(e,"P",{"data-svelte-h":!0}),m(te)!=="svelte-symkrg"&&(te.innerHTML=xt),Qe=i(e),$(le.$$.fragment,e),Se=i(e),ne=a(e,"P",{"data-svelte-h":!0}),m(ne)!=="svelte-11wfsgb"&&(ne.textContent=yt),Ae=i(e),$(se.$$.fragment,e),qe=i(e),pe=a(e,"P",{}),_t(pe).forEach(l),this.h()},h(){Oe(h,"name","hf:doc:metadata"),Oe(h,"content",It),Oe(w,"class","flex justify-center"),Oe(b,"class","flex justify-center")},m(e,t){Ut(document.head,h),n(e,ae,t),n(e,ie,t),n(e,me,t),r(d,e,t),n(e,fe,t),r(C,e,t),n(e,$e,t),n(e,M,t),n(e,re,t),n(e,g,t),n(e,oe,t),n(e,T,t),n(e,ue,t),n(e,x,t),n(e,ve,t),n(e,y,t),n(e,ce,t),r(_,e,t),n(e,he,t),n(e,L,t),n(e,we,t),n(e,j,t),n(e,be,t),n(e,H,t),n(e,de,t),n(e,w,t),n(e,Ce,t),n(e,J,t),n(e,Me,t),r(k,e,t),n(e,ge,t),n(e,P,t),n(e,Te,t),r(U,e,t),n(e,xe,t),n(e,b,t),n(e,ye,t),n(e,G,t),n(e,_e,t),r(Z,e,t),n(e,Le,t),n(e,W,t),n(e,je,t),r(I,e,t),n(e,He,t),n(e,z,t),n(e,Je,t),n(e,B,t),n(e,ke,t),n(e,V,t),n(e,Pe,t),n(e,X,t),n(e,Ue,t),n(e,E,t),n(e,Ge,t),r(R,e,t),n(e,Ze,t),n(e,N,t),n(e,We,t),r(F,e,t),n(e,Ie,t),n(e,Y,t),n(e,ze,t),r(Q,e,t),n(e,Be,t),r(S,e,t),n(e,Ve,t),n(e,A,t),n(e,Xe,t),r(q,e,t),n(e,Ee,t),n(e,D,t),n(e,Re,t),r(O,e,t),n(e,Ne,t),r(K,e,t),n(e,Fe,t),r(ee,e,t),n(e,Ye,t),n(e,te,t),n(e,Qe,t),r(le,e,t),n(e,Se,t),n(e,ne,t),n(e,Ae,t),r(se,e,t),n(e,qe,t),n(e,pe,t),De=!0},p:jt,i(e){De||(o(d.$$.fragment,e),o(C.$$.fragment,e),o(_.$$.fragment,e),o(k.$$.fragment,e),o(U.$$.fragment,e),o(Z.$$.fragment,e),o(I.$$.fragment,e),o(R.$$.fragment,e),o(F.$$.fragment,e),o(Q.$$.fragment,e),o(S.$$.fragment,e),o(q.$$.fragment,e),o(O.$$.fragment,e),o(K.$$.fragment,e),o(ee.$$.fragment,e),o(le.$$.fragment,e),o(se.$$.fragment,e),De=!0)},o(e){u(d.$$.fragment,e),u(C.$$.fragment,e),u(_.$$.fragment,e),u(k.$$.fragment,e),u(U.$$.fragment,e),u(Z.$$.fragment,e),u(I.$$.fragment,e),u(R.$$.fragment,e),u(F.$$.fragment,e),u(Q.$$.fragment,e),u(S.$$.fragment,e),u(q.$$.fragment,e),u(O.$$.fragment,e),u(K.$$.fragment,e),u(ee.$$.fragment,e),u(le.$$.fragment,e),u(se.$$.fragment,e),De=!1},d(e){e&&(l(ae),l(ie),l(me),l(fe),l($e),l(M),l(re),l(g),l(oe),l(T),l(ue),l(x),l(ve),l(y),l(ce),l(he),l(L),l(we),l(j),l(be),l(H),l(de),l(w),l(Ce),l(J),l(Me),l(ge),l(P),l(Te),l(xe),l(b),l(ye),l(G),l(_e),l(Le),l(W),l(je),l(He),l(z),l(Je),l(B),l(ke),l(V),l(Pe),l(X),l(Ue),l(E),l(Ge),l(Ze),l(N),l(We),l(Ie),l(Y),l(ze),l(Be),l(Ve),l(A),l(Xe),l(Ee),l(D),l(Re),l(Ne),l(Fe),l(Ye),l(te),l(Qe),l(Se),l(ne),l(Ae),l(qe),l(pe)),l(h),v(d,e),v(C,e),v(_,e),v(k,e),v(U,e),v(Z,e),v(I,e),v(R,e),v(F,e),v(Q,e),v(S,e),v(q,e),v(O,e),v(K,e),v(ee,e),v(le,e),v(se,e)}}}const It='{"title":"강의 소개","local":"강의-소개","sections":[{"title":"Google Colab 노트북 사용하기","local":"google-colab-노트북-사용하기","sections":[],"depth":2},{"title":"파이썬 가상 환경 사용하기","local":"파이썬-가상-환경-사용하기","sections":[{"title":"의존성(dependencies) 설치하기","local":"의존성dependencies-설치하기","sections":[],"depth":3}],"depth":2}],"depth":1}';function zt(et){return Ht(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Rt extends Jt{constructor(h){super(),kt(this,h,zt,Wt,Lt,{})}}export{Rt as component};