course/pr_1194/pt/_app/immutable/nodes/2.e70da2ff.js

import{s as _t,n as kt,o as jt}from"../chunks/scheduler.505acc25.js";import{S as Lt,i as qt,e as i,s,c as m,h as Ht,a as l,d as a,b as n,f as Pt,g as p,j as r,k as Oe,l as Jt,m as o,n as u,t as c,o as d,p as f}from"../chunks/index.1238bded.js";import{C as Ut,H as Ke,E as It}from"../chunks/MermaidChart.svelte_svelte_type_style_lang.3544e970.js";import{C as v}from"../chunks/CodeBlock.df437d75.js";function Gt(et){let $,le,ne,re,g,me,y,pe,w,tt='Bem-vindo(a) ao curso da Hugging Face! Essa introdução te guiará para a configuração do ambiente de trabalho. Se você está começando agora o curso, nós recomendamos que você primeiramente dê uma olhada no <a href="/course/chapter1">Capítulo 1</a>, para só então voltar aqui, configurar o ambiente e começar a por a mão no código.',ue,C,at="Todas as bibliotecas que usaremos nesse curso estão disponíveis como pacotes do Python, então aqui iremos te mostrar como configurar o ambiente no Python e instalar as bibliotecas específicas que você precisará.",ce,M,ot="Abordaremos 2 modos de configurar o ambiente, usando um Colab notebook ou um ambiente virtual Python. Fique à vontade para escolher o que mais fizer sentido para você.  Para os iniciantes, recomendamos fortemente que vocês iniciem pelo Colab notebook.",de,T,st="Note que nós não iremos cobrir o básico sobre o Windows. Se você estiver usando o Windows, recomendamos seguir as instruções pelo Colab notebook. Se estiver usando Linux ou macOS, você pode escolher qualquer uma das abordagens descritas aqui.",fe,x,nt='A maior parte do curso depende de você ter uma conta na Hugging Face. Recomendamos criar uma agora <a href="https://huggingface.co/join" rel="nofollow">criar uma conta</a>.',ve,P,$e,_,it="Usar um notebook Colab é a maneira mais simples possível de configuração, coloque um notebook no seu navegador e se prepare para a codificação!",be,k,lt=`Se você não está familiarizado com o Colab, recomendamos seguir essa [introdução]
(<a href="https://colab.research.google.com/notebooks/intro.ipynb" rel="nofollow">https://colab.research.google.com/notebooks/intro.ipynb</a>). O Colab permitirá você usar algumas acelerações de hardware, como GPUs ou TPUs, e é gratuito para ambientes de trabalho pequenos.`,he,j,rt="Uma vez que você estiver confortável com o ambiente do Colab, crie um novo notebook e comece com essa configuração:",ge,b,mt='<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>',ye,L,pt="O próximo passo é instalar as bibliotecas que serão usadas nesse curso. Usaremos <code>pip</code> para a instalação, que é o gerenciador de pacotes do Python. Nos notebooks, você pode rodar os comandos do sistema precedendo do caractere <code>!</code>, então você poderá instalar a biblioteca 🤗 Transformers da seguinte forma:",we,q,Ce,H,ut="Você pode assegurar que o pacote foi instalado corretamente por meio de sua importação dentro do ambiente de execução do Python:",Me,J,Te,h,ct='<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%"/>',xe,U,dt="Isso instalará uma versão bem leve da 🤗 Transformers. Em particular, nenhum framework de aprendizagem de máquina (como PyTorch ou TensorFlow) estão instalados. Desde que iremos usar bastante de suas features na biblioteca, recomendamos instalar a versão de desenvolvimento, que vem com todas as dependências requisitadas para cada caso de uso imaginável:",Pe,I,_e,G,ft="Isso levará um pouco de tempo, mas quando acabar você estará pronto/a para seguir o resto do curso!",ke,z,je,Z,vt='Se você perferir usar o ambiente virtual Python, o primeiro passo é instalar o Python no seu sistema. Nós recomendamos <a href="https://realpython.com/installing-python/" rel="nofollow">esse guia</a> para começar.',Le,W,$t="Uma vez instalado o Python, você será capaz de rodar os comandos do Python em seu terminal. Você pode iniciar por rodar o seguinte comando para ter certeza que está instalado corretamente antes de iniciar os seguintes passos: <code>python --version</code>. Isso irá imprimir na tela a versão do Python disponível no seu sistema.",qe,V,bt="Quando você rodar um comando Python no seu terminal, como o <code>python --version</code>, você deve imaginar como um programa rodando seu comando como o “main” Python no seu sistema. Recomendamos manter essa instalação livre de qualquer pacote, e usando a para criar ambientes separados para cada aplicação que você for trabalhar - desse modo, cada aplicação pode ter suas próprias dependências e pacotes, e você não precisará se preocupar sobre potenciais problemas de compatibilidades com outras aplicações.",He,N,ht='No Python isso é feito com <a href="https://docs.python.org/3/tutorial/venv.html" rel="nofollow"><em>ambientes virtuais</em></a>, que é uma árvore de diretórios que contém a instalação do Python com uma versão particular do mesmo juntamente com todos os pacotes que a aplicação precisa. Criar um ambiente virtual como esse pode ser feito com inúmeras ferramentas, mas usaremos o pacote oficial do Python para esse propósito, que se chama <a href="https://docs.python.org/3/library/venv.html#module-venv" rel="nofollow"><code>venv</code></a>.',Je,B,gt="Primeiro, crie o diretório que você gostaria que sua aplicação existisse - por exemplo, você pode querer criar um novo diretório chamado <em>curso-transformers</em> na raíz de seu diretório home:",Ue,E,Ie,R,yt="Dentro desse diretório, crie um ambiente virtual usando o módulo Python <code>venv</code>:",Ge,X,ze,F,wt="Agora você deve ter dentro um diretório chamado <em>.env</em> em sua pasta vazia:",Ze,S,We,Y,Ve,A,Ct="Você pode acessar e sair do seu ambiente virtual com os scripts <code>activate</code> e <code>deactivate</code>:",Ne,Q,Be,D,Mt="Você pode ter certeza que seu ambiente virtual está ativado rodando o comando <code>which python</code>: se ele apontar para o ambiente virtual, então você conseguiu ativa-lo com sucesso!",Ee,O,Re,K,Xe,ee,Fe,te,Tt="Como na seção passada usando as instâncias do Google Colab, você precisará instalar os pacotes necessários para continuar. Novamente, você pode instalar a versão de desenvolvimento da 🤗 Transformers usando o gerenciador de pacotes <code>pip</code>:",Se,ae,Ye,oe,xt="Você agora configurou tudo e está pronto para seguir!",Ae,se,Qe,ie,De;return g=new Ut({props:{containerStyle:"float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"}}),y=new Ke({props:{title:"Introdução",local:"introdução",headingTag:"h1"}}),P=new Ke({props:{title:"Usando um notebook Google Colab",local:"usando-um-notebook-google-colab",headingTag:"h2"}}),q=new v({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnM=",highlighted:'!pip <span class="hljs-keyword">install</span> transformers',wrap:!1}}),J=new v({props:{code:"aW1wb3J0JTIwdHJhbnNmb3JtZXJz",highlighted:'<span class="hljs-keyword">import</span> transformers',wrap:!1}}),I=new v({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnMlNUJzZW50ZW5jZXBpZWNlJTVE",highlighted:'!pip <span class="hljs-keyword">install</span> transformers[sentencepiece]',wrap:!1}}),z=new Ke({props:{title:"Usando um ambiente virtual Python",local:"usando-um-ambiente-virtual-python",headingTag:"h2"}}),E=new v({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}}),X=new v({props:{code:"cHl0aG9uJTIwLW0lMjB2ZW52JTIwLmVudg==",highlighted:'<span class="hljs-keyword">python</span> -m venv .<span class="hljs-keyword">env</span>',wrap:!1}}),S=new v({props:{code:"bHMlMjAtYQ==",highlighted:'<span class="hljs-built_in">ls</span> -a',wrap:!1}}),Y=new v({props:{code:"LiUyMCUyMCUyMCUyMCUyMCUyMC4uJTIwJTIwJTIwJTIwLmVudg==",highlighted:'.      <span class="hljs-string">..</span>    <span class="hljs-string">.env</span>',wrap:!1}}),Q=new v({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 v({props:{code:"d2hpY2glMjBweXRob24=",highlighted:'<span class="hljs-built_in">which</span> python',wrap:!1}}),K=new v({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:"Instalando dependências",local:"instalando-dependências",headingTag:"h3"}}),ae=new v({props:{code:"cGlwJTIwaW5zdGFsbCUyMCUyMnRyYW5zZm9ybWVycyU1QnNlbnRlbmNlcGllY2UlNUQlMjI=",highlighted:'pip <span class="hljs-keyword">install</span> <span class="hljs-string">&quot;transformers[sentencepiece]&quot;</span>',wrap:!1}}),se=new It({props:{source:"https://github.com/huggingface/course/blob/main/chapters/pt/chapter0/1.mdx"}}),{c(){$=i("meta"),le=s(),ne=i("p"),re=s(),m(g.$$.fragment),me=s(),m(y.$$.fragment),pe=s(),w=i("p"),w.innerHTML=tt,ue=s(),C=i("p"),C.textContent=at,ce=s(),M=i("p"),M.textContent=ot,de=s(),T=i("p"),T.textContent=st,fe=s(),x=i("p"),x.innerHTML=nt,ve=s(),m(P.$$.fragment),$e=s(),_=i("p"),_.textContent=it,be=s(),k=i("p"),k.innerHTML=lt,he=s(),j=i("p"),j.textContent=rt,ge=s(),b=i("div"),b.innerHTML=mt,ye=s(),L=i("p"),L.innerHTML=pt,we=s(),m(q.$$.fragment),Ce=s(),H=i("p"),H.textContent=ut,Me=s(),m(J.$$.fragment),Te=s(),h=i("div"),h.innerHTML=ct,xe=s(),U=i("p"),U.textContent=dt,Pe=s(),m(I.$$.fragment),_e=s(),G=i("p"),G.textContent=ft,ke=s(),m(z.$$.fragment),je=s(),Z=i("p"),Z.innerHTML=vt,Le=s(),W=i("p"),W.innerHTML=$t,qe=s(),V=i("p"),V.innerHTML=bt,He=s(),N=i("p"),N.innerHTML=ht,Je=s(),B=i("p"),B.innerHTML=gt,Ue=s(),m(E.$$.fragment),Ie=s(),R=i("p"),R.innerHTML=yt,Ge=s(),m(X.$$.fragment),ze=s(),F=i("p"),F.innerHTML=wt,Ze=s(),m(S.$$.fragment),We=s(),m(Y.$$.fragment),Ve=s(),A=i("p"),A.innerHTML=Ct,Ne=s(),m(Q.$$.fragment),Be=s(),D=i("p"),D.innerHTML=Mt,Ee=s(),m(O.$$.fragment),Re=s(),m(K.$$.fragment),Xe=s(),m(ee.$$.fragment),Fe=s(),te=i("p"),te.innerHTML=Tt,Se=s(),m(ae.$$.fragment),Ye=s(),oe=i("p"),oe.textContent=xt,Ae=s(),m(se.$$.fragment),Qe=s(),ie=i("p"),this.h()},l(e){const t=Ht("svelte-u9bgzb",document.head);$=l(t,"META",{name:!0,content:!0}),t.forEach(a),le=n(e),ne=l(e,"P",{}),Pt(ne).forEach(a),re=n(e),p(g.$$.fragment,e),me=n(e),p(y.$$.fragment,e),pe=n(e),w=l(e,"P",{"data-svelte-h":!0}),r(w)!=="svelte-1sccyy7"&&(w.innerHTML=tt),ue=n(e),C=l(e,"P",{"data-svelte-h":!0}),r(C)!=="svelte-1pookyt"&&(C.textContent=at),ce=n(e),M=l(e,"P",{"data-svelte-h":!0}),r(M)!=="svelte-hteu4b"&&(M.textContent=ot),de=n(e),T=l(e,"P",{"data-svelte-h":!0}),r(T)!=="svelte-1jj0tts"&&(T.textContent=st),fe=n(e),x=l(e,"P",{"data-svelte-h":!0}),r(x)!=="svelte-ivkibr"&&(x.innerHTML=nt),ve=n(e),p(P.$$.fragment,e),$e=n(e),_=l(e,"P",{"data-svelte-h":!0}),r(_)!=="svelte-17gq0k5"&&(_.textContent=it),be=n(e),k=l(e,"P",{"data-svelte-h":!0}),r(k)!=="svelte-sgko0w"&&(k.innerHTML=lt),he=n(e),j=l(e,"P",{"data-svelte-h":!0}),r(j)!=="svelte-1cq1pyk"&&(j.textContent=rt),ge=n(e),b=l(e,"DIV",{class:!0,"data-svelte-h":!0}),r(b)!=="svelte-1mpe2rl"&&(b.innerHTML=mt),ye=n(e),L=l(e,"P",{"data-svelte-h":!0}),r(L)!=="svelte-12fekw2"&&(L.innerHTML=pt),we=n(e),p(q.$$.fragment,e),Ce=n(e),H=l(e,"P",{"data-svelte-h":!0}),r(H)!=="svelte-wjxdgq"&&(H.textContent=ut),Me=n(e),p(J.$$.fragment,e),Te=n(e),h=l(e,"DIV",{class:!0,"data-svelte-h":!0}),r(h)!=="svelte-1cj51wg"&&(h.innerHTML=ct),xe=n(e),U=l(e,"P",{"data-svelte-h":!0}),r(U)!=="svelte-7bpxg4"&&(U.textContent=dt),Pe=n(e),p(I.$$.fragment,e),_e=n(e),G=l(e,"P",{"data-svelte-h":!0}),r(G)!=="svelte-vtko65"&&(G.textContent=ft),ke=n(e),p(z.$$.fragment,e),je=n(e),Z=l(e,"P",{"data-svelte-h":!0}),r(Z)!=="svelte-aa8hrd"&&(Z.innerHTML=vt),Le=n(e),W=l(e,"P",{"data-svelte-h":!0}),r(W)!=="svelte-138fb3f"&&(W.innerHTML=$t),qe=n(e),V=l(e,"P",{"data-svelte-h":!0}),r(V)!=="svelte-17pm0s0"&&(V.innerHTML=bt),He=n(e),N=l(e,"P",{"data-svelte-h":!0}),r(N)!=="svelte-xls7gt"&&(N.innerHTML=ht),Je=n(e),B=l(e,"P",{"data-svelte-h":!0}),r(B)!=="svelte-1odsa49"&&(B.innerHTML=gt),Ue=n(e),p(E.$$.fragment,e),Ie=n(e),R=l(e,"P",{"data-svelte-h":!0}),r(R)!=="svelte-mfntj"&&(R.innerHTML=yt),Ge=n(e),p(X.$$.fragment,e),ze=n(e),F=l(e,"P",{"data-svelte-h":!0}),r(F)!=="svelte-12wnrn8"&&(F.innerHTML=wt),Ze=n(e),p(S.$$.fragment,e),We=n(e),p(Y.$$.fragment,e),Ve=n(e),A=l(e,"P",{"data-svelte-h":!0}),r(A)!=="svelte-gngv1z"&&(A.innerHTML=Ct),Ne=n(e),p(Q.$$.fragment,e),Be=n(e),D=l(e,"P",{"data-svelte-h":!0}),r(D)!=="svelte-1usv6k6"&&(D.innerHTML=Mt),Ee=n(e),p(O.$$.fragment,e),Re=n(e),p(K.$$.fragment,e),Xe=n(e),p(ee.$$.fragment,e),Fe=n(e),te=l(e,"P",{"data-svelte-h":!0}),r(te)!=="svelte-1nh9cdm"&&(te.innerHTML=Tt),Se=n(e),p(ae.$$.fragment,e),Ye=n(e),oe=l(e,"P",{"data-svelte-h":!0}),r(oe)!=="svelte-1ag3kf5"&&(oe.textContent=xt),Ae=n(e),p(se.$$.fragment,e),Qe=n(e),ie=l(e,"P",{}),Pt(ie).forEach(a),this.h()},h(){Oe($,"name","hf:doc:metadata"),Oe($,"content",zt),Oe(b,"class","flex justify-center"),Oe(h,"class","flex justify-center")},m(e,t){Jt(document.head,$),o(e,le,t),o(e,ne,t),o(e,re,t),u(g,e,t),o(e,me,t),u(y,e,t),o(e,pe,t),o(e,w,t),o(e,ue,t),o(e,C,t),o(e,ce,t),o(e,M,t),o(e,de,t),o(e,T,t),o(e,fe,t),o(e,x,t),o(e,ve,t),u(P,e,t),o(e,$e,t),o(e,_,t),o(e,be,t),o(e,k,t),o(e,he,t),o(e,j,t),o(e,ge,t),o(e,b,t),o(e,ye,t),o(e,L,t),o(e,we,t),u(q,e,t),o(e,Ce,t),o(e,H,t),o(e,Me,t),u(J,e,t),o(e,Te,t),o(e,h,t),o(e,xe,t),o(e,U,t),o(e,Pe,t),u(I,e,t),o(e,_e,t),o(e,G,t),o(e,ke,t),u(z,e,t),o(e,je,t),o(e,Z,t),o(e,Le,t),o(e,W,t),o(e,qe,t),o(e,V,t),o(e,He,t),o(e,N,t),o(e,Je,t),o(e,B,t),o(e,Ue,t),u(E,e,t),o(e,Ie,t),o(e,R,t),o(e,Ge,t),u(X,e,t),o(e,ze,t),o(e,F,t),o(e,Ze,t),u(S,e,t),o(e,We,t),u(Y,e,t),o(e,Ve,t),o(e,A,t),o(e,Ne,t),u(Q,e,t),o(e,Be,t),o(e,D,t),o(e,Ee,t),u(O,e,t),o(e,Re,t),u(K,e,t),o(e,Xe,t),u(ee,e,t),o(e,Fe,t),o(e,te,t),o(e,Se,t),u(ae,e,t),o(e,Ye,t),o(e,oe,t),o(e,Ae,t),u(se,e,t),o(e,Qe,t),o(e,ie,t),De=!0},p:kt,i(e){De||(c(g.$$.fragment,e),c(y.$$.fragment,e),c(P.$$.fragment,e),c(q.$$.fragment,e),c(J.$$.fragment,e),c(I.$$.fragment,e),c(z.$$.fragment,e),c(E.$$.fragment,e),c(X.$$.fragment,e),c(S.$$.fragment,e),c(Y.$$.fragment,e),c(Q.$$.fragment,e),c(O.$$.fragment,e),c(K.$$.fragment,e),c(ee.$$.fragment,e),c(ae.$$.fragment,e),c(se.$$.fragment,e),De=!0)},o(e){d(g.$$.fragment,e),d(y.$$.fragment,e),d(P.$$.fragment,e),d(q.$$.fragment,e),d(J.$$.fragment,e),d(I.$$.fragment,e),d(z.$$.fragment,e),d(E.$$.fragment,e),d(X.$$.fragment,e),d(S.$$.fragment,e),d(Y.$$.fragment,e),d(Q.$$.fragment,e),d(O.$$.fragment,e),d(K.$$.fragment,e),d(ee.$$.fragment,e),d(ae.$$.fragment,e),d(se.$$.fragment,e),De=!1},d(e){e&&(a(le),a(ne),a(re),a(me),a(pe),a(w),a(ue),a(C),a(ce),a(M),a(de),a(T),a(fe),a(x),a(ve),a($e),a(_),a(be),a(k),a(he),a(j),a(ge),a(b),a(ye),a(L),a(we),a(Ce),a(H),a(Me),a(Te),a(h),a(xe),a(U),a(Pe),a(_e),a(G),a(ke),a(je),a(Z),a(Le),a(W),a(qe),a(V),a(He),a(N),a(Je),a(B),a(Ue),a(Ie),a(R),a(Ge),a(ze),a(F),a(Ze),a(We),a(Ve),a(A),a(Ne),a(Be),a(D),a(Ee),a(Re),a(Xe),a(Fe),a(te),a(Se),a(Ye),a(oe),a(Ae),a(Qe),a(ie)),a($),f(g,e),f(y,e),f(P,e),f(q,e),f(J,e),f(I,e),f(z,e),f(E,e),f(X,e),f(S,e),f(Y,e),f(Q,e),f(O,e),f(K,e),f(ee,e),f(ae,e),f(se,e)}}}const zt='{"title":"Introdução","local":"introdução","sections":[{"title":"Usando um notebook Google Colab","local":"usando-um-notebook-google-colab","sections":[],"depth":2},{"title":"Usando um ambiente virtual Python","local":"usando-um-ambiente-virtual-python","sections":[{"title":"Instalando dependências","local":"instalando-dependências","sections":[],"depth":3}],"depth":2}],"depth":1}';function Zt(et){return jt(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Et extends Lt{constructor($){super(),qt(this,$,Zt,Gt,_t,{})}}export{Et as component};