course/pr_1069/ko/_app/immutable/nodes/2.b387311d.js

import{s as xt,n as _t,o as jt}from"../chunks/scheduler.37c15a92.js";import{S as Ht,i as Lt,g as p,s,r as f,A as Jt,h as a,f as l,c as i,j as yt,u as r,x as m,k as qe,y as kt,a as n,v as $,d as o,t as u,w as v}from"../chunks/index.2bf4358c.js";import{C as c}from"../chunks/CodeBlock.4e987730.js";import{H as De,E as Pt}from"../chunks/getInferenceSnippets.24b50994.js";function Ut(Oe){let h,pe,se,ae,b,me,C,Ke='Hugging Face 강의에 오신 여러분들 환영합니다! 이번 강의 소개에서는 작업 환경 설정에 대해 안내드리겠습니다. 방금 막 이번 과정을 시작하셨다면 먼저 <a href="/course/chapter1">Chapter 1</a> 내용을 살펴보고 돌아오신 뒤, 환경을 설정하여 코드를 직접 실행해보시길 추천드립니다.',fe,M,et="이번 과정에서 사용할 모든 라이브러리는 파이썬 패키지를 통해 사용할 수 있으므로 여기서는 파이썬 환경 설정 방법 및 필요한 라이브러리 설치 방법을 보여드리겠습니다.",re,g,tt="작업 환경 설정 방법으로 Colab 노트북을 이용한 방법과 파이썬 가상 환경을 이용한 방법, 두 가지를 다룰 것이고 둘 중 더 마음이 가는 방식을 자유롭게 선택하셔도 됩니다. 입문자의 경우 Colab 노트북을 이용하시길 강력하게 추천합니다.",$e,T,lt="여기서 Windows 환경에 대해서는 다루지 않기 때문에 Windows에서 실행 중이시면 Colab 노트북을 이용해 아래 과정을 따라가 주시길 권장드립니다. Linux 혹은 macOS를 실행 중이시라면 어떤 방식을 택해도 무방합니다.",oe,y,nt='대부분의 강의는 여러분이 Hugging Face 계정이 있다는 것을 전제로 하기 때문에 지금 바로 계정을 생성하시길 추천드립니다: <a href="https://huggingface.co/join" rel="nofollow">계정 생성하기</a>',ue,x,ve,_,st="Colab 노트북은 가장 쉬운 설정 방식입니다. 브라우저에 Colab 노트북을 켜고 바로 코딩을 시작하시면 됩니다!",ce,j,it='Colab에 익숙하지 않으시다면 <a href="https://colab.research.google.com/notebooks/intro.ipynb" rel="nofollow">introduction</a> 링크를 따라 시작하시길 권장드립니다. Colab에서는 GPU, TPU와 같은 가속 하드웨어를 사용할 수 있으며 적은 양의 워크로드에 대해서는 무료입니다.',he,H,pt="Colab과 친숙해 지셨다면 새로운 노트북을 생성하여 아래와 같이 시작합니다:",we,w,at='<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>',de,L,mt="다음으로, 이번 강의에서 사용할 라이브러리를 설치합니다. 설치에는 파이썬 패키지 관리자인 <code>pip</code> 를 사용하도록 하겠습니다. 노트북 파일에서는 시스템 명령어 앞에 <code>!</code> 를 붙여 실행시킬 수 있으므로, 아래와 같이 🤗 Transformers 라이브러리를 설치할 수 있습니다:",be,J,Ce,k,ft="이제 파이썬 런타임에 패키지를 가져와 패키지가 제대로 설치되었는지 확인해보겠습니다:",Me,P,ge,d,rt='<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%"/>',Te,U,$t="위의 방식으로는 아주 가벼운 버전의 🤗 Transformers가 설치되고, 이는 PyTorch나 TensorFlow와 같은 특정 기계학습 프레임워크를 포함하지 않습니다. 하지만 본 강의에서는 이 라이브러리의 아주 다양한 기능들을 사용할 예정이므로, 아래의 명령어를 통해 대부분의 예제에 필요한 종속성(dependency)을 제공하는 개발 버전을 설치하시길 바랍니다:",ye,G,xe,Z,ot="설치에 시간이 조금 걸리지만 곧 강의를 위한 준비가 모두 끝납니다!",_e,W,je,I,ut='파이썬 가상 환경 사용을 원하신다면 먼저 파이썬을 설치해야 합니다. 이 <a href="https://realpython.com/installing-python/" rel="nofollow">가이드</a>를 따라 설치를 진행하실 수 있습니다.',He,z,vt="파이썬 설치가 완료되면 터미널에서 파이썬 명령어를 실행할 수 있습니다. 다음 단계로 넘어가기 전에, 다음과 같은 명령어를 실행하여 설치가 잘 되었는지 확인하세요: <code>python --version</code>. 이 때 시스템에 사용할 수 있는 파이썬 버전을 출력되어야 합니다.",Le,B,ct="터미널에서 <code>python --version</code> 과 같은 파이썬 명령어를 실행하면, 명령어를 실행하는 프로그램을 시스템의 “메인(main)” 파이썬으로 생각해야 합니다. 이 메인 파이썬은 어떤 패키지도 설치하지 않은 상태로 유지하면서, 작업 중인 각 어플리케이션마다 별도의 환경을 생성하여 이용하는 것을 권장합니다. 이렇게 하면, 각 어플리케이션은 각각의 의존성 및 패키지를 갖게 되어 다른 어플리케이션과의 잠재적 호환성 문제를 피할 수 있습니다.",Je,V,ht='파이썬에서 이는 <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> 를 통해 생성해 보겠습니다.',ke,X,wt="먼저, 어플리케이션을 넣어줄 디렉토리를 생성합니다. 예를 들어, 홈 디렉토리의 <em>transformers-course</em>와 같은 이름의 디렉토리를 만들어 봅시다:",Pe,E,Ue,R,dt="디렉토리 내부에서, 파이썬 <code>venv</code> 모듈을 사용하여 가상 환경을 생성합니다:",Ge,N,Ze,F,bt="원래 아무것도 없던 빈 폴더에 <em>.env</em>라는 디렉토리가 생기게 됩니다:",We,Y,Ie,Q,ze,A,Ct="<code>activate</code> 스크립트를 통해 가상 환경으로 접속할 수 있고, <code>deactivate</code> 를 통해 가상 환경 밖으로 나올 수 있습니다:",Be,S,Ve,q,Mt="환경이 제대로 활성화 되었는지 <code>which python</code> 명령어를 실행하여 확인해 봅시다. 아래와 같이 가상 환경을 보여준다면 제대로 활성화가 것입니다!",Xe,D,Ee,O,Re,K,Ne,ee,gt="Google Colab 사용법에서와 마찬가지로 다음 단계로 넘어가기 위해 패키지를 설치해야 합니다. 여기서도, <code>pip</code> 패키지 관리자를 통해  🤗 Transformers 개발 버전을 설치할 수 있습니다:",Fe,te,Ye,le,Tt="이제 모든 환경 설정을 마치고 시작할 준비가 되었습니다!",Qe,ne,Ae,ie,Se;return b=new De({props:{title:"강의 소개",local:"강의-소개",headingTag:"h1"}}),x=new De({props:{title:"Google Colab 노트북 사용하기",local:"google-colab-노트북-사용하기",headingTag:"h2"}}),J=new c({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnM=",highlighted:'!pip <span class="hljs-keyword">install</span> transformers',wrap:!1}}),P=new c({props:{code:"aW1wb3J0JTIwdHJhbnNmb3JtZXJz",highlighted:'<span class="hljs-keyword">import</span> transformers',wrap:!1}}),G=new c({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnMlNUJzZW50ZW5jZXBpZWNlJTVE",highlighted:'!pip <span class="hljs-keyword">install</span> transformers[sentencepiece]',wrap:!1}}),W=new De({props:{title:"파이썬 가상 환경 사용하기",local:"파이썬-가상-환경-사용하기",headingTag:"h2"}}),E=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}}),N=new c({props:{code:"cHl0aG9uJTIwLW0lMjB2ZW52JTIwLmVudg==",highlighted:'<span class="hljs-keyword">python</span> -m venv .<span class="hljs-keyword">env</span>',wrap:!1}}),Y=new c({props:{code:"bHMlMjAtYQ==",highlighted:'<span class="hljs-built_in">ls</span> -a',wrap:!1}}),Q=new c({props:{code:"LiUyMCUyMCUyMCUyMCUyMCUyMC4uJTIwJTIwJTIwJTIwLmVudg==",highlighted:'.      <span class="hljs-string">..</span>    <span class="hljs-string">.env</span>',wrap:!1}}),S=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}}),D=new c({props:{code:"d2hpY2glMjBweXRob24=",highlighted:'<span class="hljs-built_in">which</span> python',wrap:!1}}),O=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}}),K=new De({props:{title:"의존성(dependencies) 설치하기",local:"의존성dependencies-설치하기",headingTag:"h3"}}),te=new c({props:{code:"cGlwJTIwaW5zdGFsbCUyMCUyMnRyYW5zZm9ybWVycyU1QnNlbnRlbmNlcGllY2UlNUQlMjI=",highlighted:'pip <span class="hljs-keyword">install</span> <span class="hljs-string">&quot;transformers[sentencepiece]&quot;</span>',wrap:!1}}),ne=new Pt({props:{source:"https://github.com/huggingface/course/blob/main/chapters/ko/chapter0/1.mdx"}}),{c(){h=p("meta"),pe=s(),se=p("p"),ae=s(),f(b.$$.fragment),me=s(),C=p("p"),C.innerHTML=Ke,fe=s(),M=p("p"),M.textContent=et,re=s(),g=p("p"),g.textContent=tt,$e=s(),T=p("p"),T.textContent=lt,oe=s(),y=p("p"),y.innerHTML=nt,ue=s(),f(x.$$.fragment),ve=s(),_=p("p"),_.textContent=st,ce=s(),j=p("p"),j.innerHTML=it,he=s(),H=p("p"),H.textContent=pt,we=s(),w=p("div"),w.innerHTML=at,de=s(),L=p("p"),L.innerHTML=mt,be=s(),f(J.$$.fragment),Ce=s(),k=p("p"),k.textContent=ft,Me=s(),f(P.$$.fragment),ge=s(),d=p("div"),d.innerHTML=rt,Te=s(),U=p("p"),U.textContent=$t,ye=s(),f(G.$$.fragment),xe=s(),Z=p("p"),Z.textContent=ot,_e=s(),f(W.$$.fragment),je=s(),I=p("p"),I.innerHTML=ut,He=s(),z=p("p"),z.innerHTML=vt,Le=s(),B=p("p"),B.innerHTML=ct,Je=s(),V=p("p"),V.innerHTML=ht,ke=s(),X=p("p"),X.innerHTML=wt,Pe=s(),f(E.$$.fragment),Ue=s(),R=p("p"),R.innerHTML=dt,Ge=s(),f(N.$$.fragment),Ze=s(),F=p("p"),F.innerHTML=bt,We=s(),f(Y.$$.fragment),Ie=s(),f(Q.$$.fragment),ze=s(),A=p("p"),A.innerHTML=Ct,Be=s(),f(S.$$.fragment),Ve=s(),q=p("p"),q.innerHTML=Mt,Xe=s(),f(D.$$.fragment),Ee=s(),f(O.$$.fragment),Re=s(),f(K.$$.fragment),Ne=s(),ee=p("p"),ee.innerHTML=gt,Fe=s(),f(te.$$.fragment),Ye=s(),le=p("p"),le.textContent=Tt,Qe=s(),f(ne.$$.fragment),Ae=s(),ie=p("p"),this.h()},l(e){const t=Jt("svelte-u9bgzb",document.head);h=a(t,"META",{name:!0,content:!0}),t.forEach(l),pe=i(e),se=a(e,"P",{}),yt(se).forEach(l),ae=i(e),r(b.$$.fragment,e),me=i(e),C=a(e,"P",{"data-svelte-h":!0}),m(C)!=="svelte-8mm6kh"&&(C.innerHTML=Ke),fe=i(e),M=a(e,"P",{"data-svelte-h":!0}),m(M)!=="svelte-1mlonw8"&&(M.textContent=et),re=i(e),g=a(e,"P",{"data-svelte-h":!0}),m(g)!=="svelte-1o0bxy7"&&(g.textContent=tt),$e=i(e),T=a(e,"P",{"data-svelte-h":!0}),m(T)!=="svelte-1vwc2p6"&&(T.textContent=lt),oe=i(e),y=a(e,"P",{"data-svelte-h":!0}),m(y)!=="svelte-58bkwz"&&(y.innerHTML=nt),ue=i(e),r(x.$$.fragment,e),ve=i(e),_=a(e,"P",{"data-svelte-h":!0}),m(_)!=="svelte-kzcti5"&&(_.textContent=st),ce=i(e),j=a(e,"P",{"data-svelte-h":!0}),m(j)!=="svelte-1fn7zqz"&&(j.innerHTML=it),he=i(e),H=a(e,"P",{"data-svelte-h":!0}),m(H)!=="svelte-zeghlw"&&(H.textContent=pt),we=i(e),w=a(e,"DIV",{class:!0,"data-svelte-h":!0}),m(w)!=="svelte-1mpe2rl"&&(w.innerHTML=at),de=i(e),L=a(e,"P",{"data-svelte-h":!0}),m(L)!=="svelte-682d6o"&&(L.innerHTML=mt),be=i(e),r(J.$$.fragment,e),Ce=i(e),k=a(e,"P",{"data-svelte-h":!0}),m(k)!=="svelte-13k6js"&&(k.textContent=ft),Me=i(e),r(P.$$.fragment,e),ge=i(e),d=a(e,"DIV",{class:!0,"data-svelte-h":!0}),m(d)!=="svelte-1cj51wg"&&(d.innerHTML=rt),Te=i(e),U=a(e,"P",{"data-svelte-h":!0}),m(U)!=="svelte-1f65mzk"&&(U.textContent=$t),ye=i(e),r(G.$$.fragment,e),xe=i(e),Z=a(e,"P",{"data-svelte-h":!0}),m(Z)!=="svelte-9o5cuf"&&(Z.textContent=ot),_e=i(e),r(W.$$.fragment,e),je=i(e),I=a(e,"P",{"data-svelte-h":!0}),m(I)!=="svelte-1ala03n"&&(I.innerHTML=ut),He=i(e),z=a(e,"P",{"data-svelte-h":!0}),m(z)!=="svelte-175door"&&(z.innerHTML=vt),Le=i(e),B=a(e,"P",{"data-svelte-h":!0}),m(B)!=="svelte-kwm5uv"&&(B.innerHTML=ct),Je=i(e),V=a(e,"P",{"data-svelte-h":!0}),m(V)!=="svelte-cohcrn"&&(V.innerHTML=ht),ke=i(e),X=a(e,"P",{"data-svelte-h":!0}),m(X)!=="svelte-17sf826"&&(X.innerHTML=wt),Pe=i(e),r(E.$$.fragment,e),Ue=i(e),R=a(e,"P",{"data-svelte-h":!0}),m(R)!=="svelte-d6u3p3"&&(R.innerHTML=dt),Ge=i(e),r(N.$$.fragment,e),Ze=i(e),F=a(e,"P",{"data-svelte-h":!0}),m(F)!=="svelte-19ufi88"&&(F.innerHTML=bt),We=i(e),r(Y.$$.fragment,e),Ie=i(e),r(Q.$$.fragment,e),ze=i(e),A=a(e,"P",{"data-svelte-h":!0}),m(A)!=="svelte-10iyx9f"&&(A.innerHTML=Ct),Be=i(e),r(S.$$.fragment,e),Ve=i(e),q=a(e,"P",{"data-svelte-h":!0}),m(q)!=="svelte-1w7twka"&&(q.innerHTML=Mt),Xe=i(e),r(D.$$.fragment,e),Ee=i(e),r(O.$$.fragment,e),Re=i(e),r(K.$$.fragment,e),Ne=i(e),ee=a(e,"P",{"data-svelte-h":!0}),m(ee)!=="svelte-symkrg"&&(ee.innerHTML=gt),Fe=i(e),r(te.$$.fragment,e),Ye=i(e),le=a(e,"P",{"data-svelte-h":!0}),m(le)!=="svelte-11wfsgb"&&(le.textContent=Tt),Qe=i(e),r(ne.$$.fragment,e),Ae=i(e),ie=a(e,"P",{}),yt(ie).forEach(l),this.h()},h(){qe(h,"name","hf:doc:metadata"),qe(h,"content",Gt),qe(w,"class","flex justify-center"),qe(d,"class","flex justify-center")},m(e,t){kt(document.head,h),n(e,pe,t),n(e,se,t),n(e,ae,t),$(b,e,t),n(e,me,t),n(e,C,t),n(e,fe,t),n(e,M,t),n(e,re,t),n(e,g,t),n(e,$e,t),n(e,T,t),n(e,oe,t),n(e,y,t),n(e,ue,t),$(x,e,t),n(e,ve,t),n(e,_,t),n(e,ce,t),n(e,j,t),n(e,he,t),n(e,H,t),n(e,we,t),n(e,w,t),n(e,de,t),n(e,L,t),n(e,be,t),$(J,e,t),n(e,Ce,t),n(e,k,t),n(e,Me,t),$(P,e,t),n(e,ge,t),n(e,d,t),n(e,Te,t),n(e,U,t),n(e,ye,t),$(G,e,t),n(e,xe,t),n(e,Z,t),n(e,_e,t),$(W,e,t),n(e,je,t),n(e,I,t),n(e,He,t),n(e,z,t),n(e,Le,t),n(e,B,t),n(e,Je,t),n(e,V,t),n(e,ke,t),n(e,X,t),n(e,Pe,t),$(E,e,t),n(e,Ue,t),n(e,R,t),n(e,Ge,t),$(N,e,t),n(e,Ze,t),n(e,F,t),n(e,We,t),$(Y,e,t),n(e,Ie,t),$(Q,e,t),n(e,ze,t),n(e,A,t),n(e,Be,t),$(S,e,t),n(e,Ve,t),n(e,q,t),n(e,Xe,t),$(D,e,t),n(e,Ee,t),$(O,e,t),n(e,Re,t),$(K,e,t),n(e,Ne,t),n(e,ee,t),n(e,Fe,t),$(te,e,t),n(e,Ye,t),n(e,le,t),n(e,Qe,t),$(ne,e,t),n(e,Ae,t),n(e,ie,t),Se=!0},p:_t,i(e){Se||(o(b.$$.fragment,e),o(x.$$.fragment,e),o(J.$$.fragment,e),o(P.$$.fragment,e),o(G.$$.fragment,e),o(W.$$.fragment,e),o(E.$$.fragment,e),o(N.$$.fragment,e),o(Y.$$.fragment,e),o(Q.$$.fragment,e),o(S.$$.fragment,e),o(D.$$.fragment,e),o(O.$$.fragment,e),o(K.$$.fragment,e),o(te.$$.fragment,e),o(ne.$$.fragment,e),Se=!0)},o(e){u(b.$$.fragment,e),u(x.$$.fragment,e),u(J.$$.fragment,e),u(P.$$.fragment,e),u(G.$$.fragment,e),u(W.$$.fragment,e),u(E.$$.fragment,e),u(N.$$.fragment,e),u(Y.$$.fragment,e),u(Q.$$.fragment,e),u(S.$$.fragment,e),u(D.$$.fragment,e),u(O.$$.fragment,e),u(K.$$.fragment,e),u(te.$$.fragment,e),u(ne.$$.fragment,e),Se=!1},d(e){e&&(l(pe),l(se),l(ae),l(me),l(C),l(fe),l(M),l(re),l(g),l($e),l(T),l(oe),l(y),l(ue),l(ve),l(_),l(ce),l(j),l(he),l(H),l(we),l(w),l(de),l(L),l(be),l(Ce),l(k),l(Me),l(ge),l(d),l(Te),l(U),l(ye),l(xe),l(Z),l(_e),l(je),l(I),l(He),l(z),l(Le),l(B),l(Je),l(V),l(ke),l(X),l(Pe),l(Ue),l(R),l(Ge),l(Ze),l(F),l(We),l(Ie),l(ze),l(A),l(Be),l(Ve),l(q),l(Xe),l(Ee),l(Re),l(Ne),l(ee),l(Fe),l(Ye),l(le),l(Qe),l(Ae),l(ie)),l(h),v(b,e),v(x,e),v(J,e),v(P,e),v(G,e),v(W,e),v(E,e),v(N,e),v(Y,e),v(Q,e),v(S,e),v(D,e),v(O,e),v(K,e),v(te,e),v(ne,e)}}}const Gt='{"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(Oe){return jt(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Vt extends Ht{constructor(h){super(),Lt(this,h,Zt,Ut,xt,{})}}export{Vt as component};