course/pr_1069/it/_app/immutable/nodes/2.7883dbee.js

import{s as Mt,n as xt,o as Pt}from"../chunks/scheduler.37c15a92.js";import{S as jt,i as _t,g as o,s as a,r as p,A as Ht,h as s,f as i,c as l,j as Tt,u as m,x as r,k as Re,y as Lt,a as n,v as c,d as u,t as d,w as f}from"../chunks/index.2bf4358c.js";import{C as v}from"../chunks/CodeBlock.4e987730.js";import{H as De,E as Jt}from"../chunks/getInferenceSnippets.24b50994.js";function kt(Oe){let h,oe,ae,se,g,re,z,Ke='Benvenuto/a al corso di Hugging Face! In questo capitolo introduttivo, ti aiuteremo a configurare il tuo ambiente di lavoro. Se non hai ancora cominciato il corso, ti consigliamo di dare prima un occhio al <a href="/course/chapter1">Capitolo 1</a>, per poi tornare qui a creare il tuo ambiente e cominciare a lavorare al codice.',pe,w,et="Tutte le librerie che useremo in questo corso sono disponibili come pacchetti Python. Qui ti mostreremo dapprima come configurare un ambiente Python e in seguito come installare le librerie di cui avrai bisogno.",me,C,tt="Copriremo due modi per configurare un ambiente di lavoro: usando un blocco note Colab, oppure un ambiente virtuale in Python. Sentiti libero/a di scegliere quello che ti sembra più adatto a te. Se sei un/a principiante, ti consigliamo vivamente di cominciare a lavorare con un blocco note Colab.",ce,y,it="Nota che non copriremo Windows. Se utilizzi Windows come sistema operativo, il nostro consiglio è di seguire il corso utilizzando un blocco note Colab. Se invece utilizzi Linux oppure macOS, puoi scegliere uno qualsiasi degli approcci descritti qui in seguito.",ue,T,nt='Buona parte del corso richiede un profilo di Hugging Face. Ti consigliamo dunque di crearne uno al più presto: <a href="https://huggingface.co/join" rel="nofollow">Crea un profilo</a>.',de,M,fe,x,at="Il modo più semplice di configurare il tuo ambiente di lavoro è utilizzando Google Colab: una volta avviato un blocco note nel browser, puoi iniziare immediatamente a programmare!",ve,P,lt='Se non conosci bene Colab, ti raccomandiamo di iniziare dalla seguente <a href="https://colab.research.google.com/notebooks/intro.ipynb" rel="nofollow">introduzione</a>. Colab permette di utilizzare accelerazioni hardware come GPU o TPU, ed è gratuito per i carichi di lavoro più piccoli.',he,j,ot="Quando ti sentirai a tuo agio con Colab, crea un nuovo blocco note e inizia la configurazione:",$e,$,st='<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>',be,_,rt="Il passo successivo consiste nell’installare le librerie che utilizzerai in questo corso. Per l’installazione, useremo <code>pip</code>, ossia il gestore di pacchetti di Python. In Google Colab, puoi inizializzare i tuoi comandi di sistema facendone precedere il nome dal carattere <code>!</code>. La libreria 🤗 Transformers verrà quindi installata come segue:",ge,H,ze,L,pt="Puoi assicurarti che il pacchetto sia stato installato correttamente importandolo in Python:",we,J,Ce,b,mt='<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,k,ct="Quest’operazione installa una versione molto leggera degli 🤗 Transformers che non importa nessun framework (<em>quadro strutturale</em>) di machine learning (<em>apprendimento automatico</em>), come ad esempio PyTorch o TensorFlow. Dato che useremo numerose features (<em>caratteristiche</em>) della libreria, ti raccomandiamo l’installazione della versione per sviluppatori. Questa contiene praticamente tutte le dipendenze possibili e immaginabili:",Te,I,Me,G,ut="L’operazione richiederà un po’ di tempo, ma poi sarai pronto/a per il tutto resto del corso!",xe,q,Pe,U,dt='Se preferisci utilizzare un ambiente virtuale in Python, il primo passo consiste nell’installazione di Python nel tuo sistema. Ti raccomandiamo di aiutarti con <a href="https://realpython.com/installing-python/" rel="nofollow">questa guida</a>.',je,Z,ft="Quando avrai installato Python, dovresti riuscire a eseguire qualsiasi comando in Python sul terminale. Prima di procedere ai passi successivi, prova a eseguire il seguente comando per assicurarti che Python sia installato correttamente: <code>python --version</code>. Il comando dovrebbe stampare il nome della versione di Python installata nella tua macchina.",_e,W,vt="Quando esegui un comando in Python dal terminale, come ad esempio <code>python --version</code>, ti consigliamo di considerare il programma che esegue il tuo comando come l’installazione “principale” di Python del tuo sistema. La nostra raccomandazione è di tenere quest’installazione principale libera da pacchetti di ogni tipo, e di usarla per creare ambienti diversi per ogni applicazione alla quale lavorerai. In questo modo, ogni applicazione avrà le proprie dipendenze e i propri pacchetti, e non dovrai preoccuparti di eventuali problemi di compatibilità con altre applicazioni.",He,B,ht='In Python, quest’operazione si effettua utilizzando i <a href="https://docs.python.org/3/tutorial/venv.html" rel="nofollow">virtual environments</a> (<em>ambienti virtuali</em>). Questi ultimi sono degli alberi di directory autonomi che contengono installazioni di Python diverse, ossia particolari versioni di Python unite a tutti i pacchetti richiesti da una certa applicazione. La creazione di ambienti virtuali di questo tipo si può attuare a mezzo di strumenti diversi, anche se qui useremo esclusivamente il pacchetto ufficiale di Python, <a href="https://docs.python.org/3/library/venv.html#module-venv" rel="nofollow"><code>venv</code></a>.',Le,Q,$t="Innanzitutto, crea la cartella che ospiterà l’applicazione in questione, come ad esempio una cartella di nome <em>transformer-course</em> alla radice della tua home directory:",Je,X,ke,Y,bt="All’interno di questa cartella, crea un ambiente virtuale utilizzando il modulo <code>venv</code> di Python:",Ie,E,Ge,N,gt="A questo punto, dovresti avere una cartella chiamata <em>.env</em> in quella che era la tua cartella vuota:",qe,A,Ue,S,Ze,V,zt="Puoi entrare e uscire dall’ambiente virtuale utilizzando gli script <code>activate</code> e <code>deactivate</code>:",We,F,Be,R,wt="Assicurati che l’ambiente sia configurato correttamente eseguendo il comando <code>which python</code>: se come risposta ottieni l’ambiente virtuale, significa che l’hai attivato bene!",Qe,D,Xe,O,Ye,K,Ee,ee,Ct="Come già menzionato nella sezione su Google Colab, il passo successivo consiste nell’installazione dei pacchetti richiesti dal corso. Ancora una volta, ti chiediamo di installare la versione per sviluppatori degli 🤗 Transformers utilizzando il gestore di pacchetti <code>pip</code>:",Ne,te,Ae,ie,yt="Abbiamo finito con le installazioni! Ora sei pronto/a a iniziare.",Se,ne,Ve,le,Fe;return g=new De({props:{title:"Introduzione",local:"introduzione",headingTag:"h1"}}),M=new De({props:{title:"Come usare un blocco note Colab di Google",local:"come-usare-un-blocco-note-colab-di-google",headingTag:"h2"}}),H=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}}),q=new De({props:{title:"Come usare un ambiente virtuale in Python",local:"come-usare-un-ambiente-virtuale-in-python",headingTag:"h2"}}),X=new v({props:{code:"bWtkaXIlMjB+JTJGdHJhbnNmb3JtZXItY291cnNlJTBBY2QlMjB+JTJGdHJhbnNmb3JtZXItY291cnNl",highlighted:`<span class="hljs-built_in">mkdir</span> ~/transformer-course
<span class="hljs-built_in">cd</span> ~/transformer-course`,wrap:!1}}),E=new v({props:{code:"cHl0aG9uJTIwLW0lMjB2ZW52JTIwLmVudg==",highlighted:'<span class="hljs-keyword">python</span> -m venv .<span class="hljs-keyword">env</span>',wrap:!1}}),A=new v({props:{code:"bHMlMjAtYQ==",highlighted:'<span class="hljs-built_in">ls</span> -a',wrap:!1}}),S=new v({props:{code:"LiUyMCUyMCUyMCUyMCUyMCUyMC4uJTIwJTIwJTIwJTIwLmVudg==",highlighted:'.      <span class="hljs-string">..</span>    <span class="hljs-string">.env</span>',wrap:!1}}),F=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}}),D=new v({props:{code:"d2hpY2glMjBweXRob24=",highlighted:'<span class="hljs-built_in">which</span> python',wrap:!1}}),O=new v({props:{code:"JTJGaG9tZSUyRiUzQ3VzZXIlM0UlMkZ0cmFuc2Zvcm1lci1jb3Vyc2UlMkYuZW52JTJGYmluJTJGcHl0aG9u",highlighted:'<span class="hljs-regexp">/home/</span>&lt;user&gt;<span class="hljs-regexp">/transformer-course/</span>.env<span class="hljs-regexp">/bin/</span>python',wrap:!1}}),K=new De({props:{title:"Installazione dipendenze",local:"installazione-dipendenze",headingTag:"h3"}}),te=new v({props:{code:"cGlwJTIwaW5zdGFsbCUyMCUyMnRyYW5zZm9ybWVycyU1QnNlbnRlbmNlcGllY2UlNUQlMjI=",highlighted:'pip <span class="hljs-keyword">install</span> <span class="hljs-string">&quot;transformers[sentencepiece]&quot;</span>',wrap:!1}}),ne=new Jt({props:{source:"https://github.com/huggingface/course/blob/main/chapters/it/chapter0/1.mdx"}}),{c(){h=o("meta"),oe=a(),ae=o("p"),se=a(),p(g.$$.fragment),re=a(),z=o("p"),z.innerHTML=Ke,pe=a(),w=o("p"),w.textContent=et,me=a(),C=o("p"),C.textContent=tt,ce=a(),y=o("p"),y.textContent=it,ue=a(),T=o("p"),T.innerHTML=nt,de=a(),p(M.$$.fragment),fe=a(),x=o("p"),x.textContent=at,ve=a(),P=o("p"),P.innerHTML=lt,he=a(),j=o("p"),j.textContent=ot,$e=a(),$=o("div"),$.innerHTML=st,be=a(),_=o("p"),_.innerHTML=rt,ge=a(),p(H.$$.fragment),ze=a(),L=o("p"),L.textContent=pt,we=a(),p(J.$$.fragment),Ce=a(),b=o("div"),b.innerHTML=mt,ye=a(),k=o("p"),k.innerHTML=ct,Te=a(),p(I.$$.fragment),Me=a(),G=o("p"),G.textContent=ut,xe=a(),p(q.$$.fragment),Pe=a(),U=o("p"),U.innerHTML=dt,je=a(),Z=o("p"),Z.innerHTML=ft,_e=a(),W=o("p"),W.innerHTML=vt,He=a(),B=o("p"),B.innerHTML=ht,Le=a(),Q=o("p"),Q.innerHTML=$t,Je=a(),p(X.$$.fragment),ke=a(),Y=o("p"),Y.innerHTML=bt,Ie=a(),p(E.$$.fragment),Ge=a(),N=o("p"),N.innerHTML=gt,qe=a(),p(A.$$.fragment),Ue=a(),p(S.$$.fragment),Ze=a(),V=o("p"),V.innerHTML=zt,We=a(),p(F.$$.fragment),Be=a(),R=o("p"),R.innerHTML=wt,Qe=a(),p(D.$$.fragment),Xe=a(),p(O.$$.fragment),Ye=a(),p(K.$$.fragment),Ee=a(),ee=o("p"),ee.innerHTML=Ct,Ne=a(),p(te.$$.fragment),Ae=a(),ie=o("p"),ie.textContent=yt,Se=a(),p(ne.$$.fragment),Ve=a(),le=o("p"),this.h()},l(e){const t=Ht("svelte-u9bgzb",document.head);h=s(t,"META",{name:!0,content:!0}),t.forEach(i),oe=l(e),ae=s(e,"P",{}),Tt(ae).forEach(i),se=l(e),m(g.$$.fragment,e),re=l(e),z=s(e,"P",{"data-svelte-h":!0}),r(z)!=="svelte-1i43de8"&&(z.innerHTML=Ke),pe=l(e),w=s(e,"P",{"data-svelte-h":!0}),r(w)!=="svelte-dxfjab"&&(w.textContent=et),me=l(e),C=s(e,"P",{"data-svelte-h":!0}),r(C)!=="svelte-k47ujn"&&(C.textContent=tt),ce=l(e),y=s(e,"P",{"data-svelte-h":!0}),r(y)!=="svelte-1ljj0xp"&&(y.textContent=it),ue=l(e),T=s(e,"P",{"data-svelte-h":!0}),r(T)!=="svelte-zkvyxj"&&(T.innerHTML=nt),de=l(e),m(M.$$.fragment,e),fe=l(e),x=s(e,"P",{"data-svelte-h":!0}),r(x)!=="svelte-1k0hbes"&&(x.textContent=at),ve=l(e),P=s(e,"P",{"data-svelte-h":!0}),r(P)!=="svelte-1p8csib"&&(P.innerHTML=lt),he=l(e),j=s(e,"P",{"data-svelte-h":!0}),r(j)!=="svelte-1y6gk5e"&&(j.textContent=ot),$e=l(e),$=s(e,"DIV",{class:!0,"data-svelte-h":!0}),r($)!=="svelte-1mpe2rl"&&($.innerHTML=st),be=l(e),_=s(e,"P",{"data-svelte-h":!0}),r(_)!=="svelte-196eb09"&&(_.innerHTML=rt),ge=l(e),m(H.$$.fragment,e),ze=l(e),L=s(e,"P",{"data-svelte-h":!0}),r(L)!=="svelte-1a2l4cc"&&(L.textContent=pt),we=l(e),m(J.$$.fragment,e),Ce=l(e),b=s(e,"DIV",{class:!0,"data-svelte-h":!0}),r(b)!=="svelte-1cj51wg"&&(b.innerHTML=mt),ye=l(e),k=s(e,"P",{"data-svelte-h":!0}),r(k)!=="svelte-qm2qt3"&&(k.innerHTML=ct),Te=l(e),m(I.$$.fragment,e),Me=l(e),G=s(e,"P",{"data-svelte-h":!0}),r(G)!=="svelte-x2u2xi"&&(G.textContent=ut),xe=l(e),m(q.$$.fragment,e),Pe=l(e),U=s(e,"P",{"data-svelte-h":!0}),r(U)!=="svelte-1vi6p3e"&&(U.innerHTML=dt),je=l(e),Z=s(e,"P",{"data-svelte-h":!0}),r(Z)!=="svelte-1uk742v"&&(Z.innerHTML=ft),_e=l(e),W=s(e,"P",{"data-svelte-h":!0}),r(W)!=="svelte-swa0xa"&&(W.innerHTML=vt),He=l(e),B=s(e,"P",{"data-svelte-h":!0}),r(B)!=="svelte-1wcffaj"&&(B.innerHTML=ht),Le=l(e),Q=s(e,"P",{"data-svelte-h":!0}),r(Q)!=="svelte-1sxjkda"&&(Q.innerHTML=$t),Je=l(e),m(X.$$.fragment,e),ke=l(e),Y=s(e,"P",{"data-svelte-h":!0}),r(Y)!=="svelte-1cqowx9"&&(Y.innerHTML=bt),Ie=l(e),m(E.$$.fragment,e),Ge=l(e),N=s(e,"P",{"data-svelte-h":!0}),r(N)!=="svelte-1i6mnx2"&&(N.innerHTML=gt),qe=l(e),m(A.$$.fragment,e),Ue=l(e),m(S.$$.fragment,e),Ze=l(e),V=s(e,"P",{"data-svelte-h":!0}),r(V)!=="svelte-hnl8kv"&&(V.innerHTML=zt),We=l(e),m(F.$$.fragment,e),Be=l(e),R=s(e,"P",{"data-svelte-h":!0}),r(R)!=="svelte-1hovdlo"&&(R.innerHTML=wt),Qe=l(e),m(D.$$.fragment,e),Xe=l(e),m(O.$$.fragment,e),Ye=l(e),m(K.$$.fragment,e),Ee=l(e),ee=s(e,"P",{"data-svelte-h":!0}),r(ee)!=="svelte-1vxcxk4"&&(ee.innerHTML=Ct),Ne=l(e),m(te.$$.fragment,e),Ae=l(e),ie=s(e,"P",{"data-svelte-h":!0}),r(ie)!=="svelte-1tjnpeu"&&(ie.textContent=yt),Se=l(e),m(ne.$$.fragment,e),Ve=l(e),le=s(e,"P",{}),Tt(le).forEach(i),this.h()},h(){Re(h,"name","hf:doc:metadata"),Re(h,"content",It),Re($,"class","flex justify-center"),Re(b,"class","flex justify-center")},m(e,t){Lt(document.head,h),n(e,oe,t),n(e,ae,t),n(e,se,t),c(g,e,t),n(e,re,t),n(e,z,t),n(e,pe,t),n(e,w,t),n(e,me,t),n(e,C,t),n(e,ce,t),n(e,y,t),n(e,ue,t),n(e,T,t),n(e,de,t),c(M,e,t),n(e,fe,t),n(e,x,t),n(e,ve,t),n(e,P,t),n(e,he,t),n(e,j,t),n(e,$e,t),n(e,$,t),n(e,be,t),n(e,_,t),n(e,ge,t),c(H,e,t),n(e,ze,t),n(e,L,t),n(e,we,t),c(J,e,t),n(e,Ce,t),n(e,b,t),n(e,ye,t),n(e,k,t),n(e,Te,t),c(I,e,t),n(e,Me,t),n(e,G,t),n(e,xe,t),c(q,e,t),n(e,Pe,t),n(e,U,t),n(e,je,t),n(e,Z,t),n(e,_e,t),n(e,W,t),n(e,He,t),n(e,B,t),n(e,Le,t),n(e,Q,t),n(e,Je,t),c(X,e,t),n(e,ke,t),n(e,Y,t),n(e,Ie,t),c(E,e,t),n(e,Ge,t),n(e,N,t),n(e,qe,t),c(A,e,t),n(e,Ue,t),c(S,e,t),n(e,Ze,t),n(e,V,t),n(e,We,t),c(F,e,t),n(e,Be,t),n(e,R,t),n(e,Qe,t),c(D,e,t),n(e,Xe,t),c(O,e,t),n(e,Ye,t),c(K,e,t),n(e,Ee,t),n(e,ee,t),n(e,Ne,t),c(te,e,t),n(e,Ae,t),n(e,ie,t),n(e,Se,t),c(ne,e,t),n(e,Ve,t),n(e,le,t),Fe=!0},p:xt,i(e){Fe||(u(g.$$.fragment,e),u(M.$$.fragment,e),u(H.$$.fragment,e),u(J.$$.fragment,e),u(I.$$.fragment,e),u(q.$$.fragment,e),u(X.$$.fragment,e),u(E.$$.fragment,e),u(A.$$.fragment,e),u(S.$$.fragment,e),u(F.$$.fragment,e),u(D.$$.fragment,e),u(O.$$.fragment,e),u(K.$$.fragment,e),u(te.$$.fragment,e),u(ne.$$.fragment,e),Fe=!0)},o(e){d(g.$$.fragment,e),d(M.$$.fragment,e),d(H.$$.fragment,e),d(J.$$.fragment,e),d(I.$$.fragment,e),d(q.$$.fragment,e),d(X.$$.fragment,e),d(E.$$.fragment,e),d(A.$$.fragment,e),d(S.$$.fragment,e),d(F.$$.fragment,e),d(D.$$.fragment,e),d(O.$$.fragment,e),d(K.$$.fragment,e),d(te.$$.fragment,e),d(ne.$$.fragment,e),Fe=!1},d(e){e&&(i(oe),i(ae),i(se),i(re),i(z),i(pe),i(w),i(me),i(C),i(ce),i(y),i(ue),i(T),i(de),i(fe),i(x),i(ve),i(P),i(he),i(j),i($e),i($),i(be),i(_),i(ge),i(ze),i(L),i(we),i(Ce),i(b),i(ye),i(k),i(Te),i(Me),i(G),i(xe),i(Pe),i(U),i(je),i(Z),i(_e),i(W),i(He),i(B),i(Le),i(Q),i(Je),i(ke),i(Y),i(Ie),i(Ge),i(N),i(qe),i(Ue),i(Ze),i(V),i(We),i(Be),i(R),i(Qe),i(Xe),i(Ye),i(Ee),i(ee),i(Ne),i(Ae),i(ie),i(Se),i(Ve),i(le)),i(h),f(g,e),f(M,e),f(H,e),f(J,e),f(I,e),f(q,e),f(X,e),f(E,e),f(A,e),f(S,e),f(F,e),f(D,e),f(O,e),f(K,e),f(te,e),f(ne,e)}}}const It='{"title":"Introduzione","local":"introduzione","sections":[{"title":"Come usare un blocco note Colab di Google","local":"come-usare-un-blocco-note-colab-di-google","sections":[],"depth":2},{"title":"Come usare un ambiente virtuale in Python","local":"come-usare-un-ambiente-virtuale-in-python","sections":[{"title":"Installazione dipendenze","local":"installazione-dipendenze","sections":[],"depth":3}],"depth":2}],"depth":1}';function Gt(Oe){return Pt(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Bt extends jt{constructor(h){super(),_t(this,h,Gt,kt,Mt,{})}}export{Bt as component};