course/pr_1114/it/_app/immutable/nodes/2.d8560f64.js

import{s as Pt,n as jt,o as _t}from"../chunks/scheduler.505acc25.js";import{S as Lt,i as Ht,e as o,s as l,c as p,h as Jt,a as s,d as i,b as a,f as xt,g as m,j as r,k as Oe,l as kt,m as n,n as u,t as c,o as d,p as f}from"../chunks/index.1238bded.js";import{C as It,H as Ke,E as Gt}from"../chunks/MermaidChart.svelte_svelte_type_style_lang.cccc31f8.js";import{C as v}from"../chunks/CodeBlock.1a76be37.js";function qt(et){let h,se,ae,re,g,pe,z,me,w,tt='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.',ue,C,it="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.",ce,y,nt="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.",de,M,lt="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.",fe,T,at='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>.',ve,x,he,P,ot="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!",$e,j,st='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.',be,_,rt="Quando ti sentirai a tuo agio con Colab, crea un nuovo blocco note e inizia la configurazione:",ge,$,pt='<img src="https://huggingface.co/datasets/huggingface-course/documentation-images/resolve/main/en/chapter0/new_colab.png" alt="An empty colab notebook" width="80%"/>',ze,L,mt="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:",we,H,Ce,J,ut="Puoi assicurarti che il pacchetto sia stato installato correttamente importandolo in Python:",ye,k,Me,b,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%"/>',Te,I,dt="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:",xe,G,Pe,q,ft="L’operazione richiederà un po’ di tempo, ma poi sarai pronto/a per il tutto resto del corso!",je,U,_e,Z,vt='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>.',Le,W,ht="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.",He,B,$t="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.",Je,Q,bt='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>.',ke,X,gt="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:",Ie,Y,Ge,E,zt="All’interno di questa cartella, crea un ambiente virtuale utilizzando il modulo <code>venv</code> di Python:",qe,N,Ue,S,wt="A questo punto, dovresti avere una cartella chiamata <em>.env</em> in quella che era la tua cartella vuota:",Ze,V,We,A,Be,F,Ct="Puoi entrare e uscire dall’ambiente virtuale utilizzando gli script <code>activate</code> e <code>deactivate</code>:",Qe,R,Xe,D,yt="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!",Ye,O,Ee,K,Ne,ee,Se,te,Mt="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>:",Ve,ie,Ae,ne,Tt="Abbiamo finito con le installazioni! Ora sei pronto/a a iniziare.",Fe,le,Re,oe,De;return g=new It({props:{containerStyle:"float: right; margin-left: 10px; display: inline-flex; position: relative; z-index: 10;"}}),z=new Ke({props:{title:"Introduzione",local:"introduzione",headingTag:"h1"}}),x=new Ke({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}}),k=new v({props:{code:"aW1wb3J0JTIwdHJhbnNmb3JtZXJz",highlighted:'<span class="hljs-keyword">import</span> transformers',wrap:!1}}),G=new v({props:{code:"IXBpcCUyMGluc3RhbGwlMjB0cmFuc2Zvcm1lcnMlNUJzZW50ZW5jZXBpZWNlJTVE",highlighted:'!pip <span class="hljs-keyword">install</span> transformers[sentencepiece]',wrap:!1}}),U=new Ke({props:{title:"Come usare un ambiente virtuale in Python",local:"come-usare-un-ambiente-virtuale-in-python",headingTag:"h2"}}),Y=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}}),N=new v({props:{code:"cHl0aG9uJTIwLW0lMjB2ZW52JTIwLmVudg==",highlighted:'<span class="hljs-keyword">python</span> -m venv .<span class="hljs-keyword">env</span>',wrap:!1}}),V=new v({props:{code:"bHMlMjAtYQ==",highlighted:'<span class="hljs-built_in">ls</span> -a',wrap:!1}}),A=new v({props:{code:"LiUyMCUyMCUyMCUyMCUyMCUyMC4uJTIwJTIwJTIwJTIwLmVudg==",highlighted:'.      <span class="hljs-string">..</span>    <span class="hljs-string">.env</span>',wrap:!1}}),R=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:"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}}),ee=new Ke({props:{title:"Installazione dipendenze",local:"installazione-dipendenze",headingTag:"h3"}}),ie=new v({props:{code:"cGlwJTIwaW5zdGFsbCUyMCUyMnRyYW5zZm9ybWVycyU1QnNlbnRlbmNlcGllY2UlNUQlMjI=",highlighted:'pip <span class="hljs-keyword">install</span> <span class="hljs-string">&quot;transformers[sentencepiece]&quot;</span>',wrap:!1}}),le=new Gt({props:{source:"https://github.com/huggingface/course/blob/main/chapters/it/chapter0/1.mdx"}}),{c(){h=o("meta"),se=l(),ae=o("p"),re=l(),p(g.$$.fragment),pe=l(),p(z.$$.fragment),me=l(),w=o("p"),w.innerHTML=tt,ue=l(),C=o("p"),C.textContent=it,ce=l(),y=o("p"),y.textContent=nt,de=l(),M=o("p"),M.textContent=lt,fe=l(),T=o("p"),T.innerHTML=at,ve=l(),p(x.$$.fragment),he=l(),P=o("p"),P.textContent=ot,$e=l(),j=o("p"),j.innerHTML=st,be=l(),_=o("p"),_.textContent=rt,ge=l(),$=o("div"),$.innerHTML=pt,ze=l(),L=o("p"),L.innerHTML=mt,we=l(),p(H.$$.fragment),Ce=l(),J=o("p"),J.textContent=ut,ye=l(),p(k.$$.fragment),Me=l(),b=o("div"),b.innerHTML=ct,Te=l(),I=o("p"),I.innerHTML=dt,xe=l(),p(G.$$.fragment),Pe=l(),q=o("p"),q.textContent=ft,je=l(),p(U.$$.fragment),_e=l(),Z=o("p"),Z.innerHTML=vt,Le=l(),W=o("p"),W.innerHTML=ht,He=l(),B=o("p"),B.innerHTML=$t,Je=l(),Q=o("p"),Q.innerHTML=bt,ke=l(),X=o("p"),X.innerHTML=gt,Ie=l(),p(Y.$$.fragment),Ge=l(),E=o("p"),E.innerHTML=zt,qe=l(),p(N.$$.fragment),Ue=l(),S=o("p"),S.innerHTML=wt,Ze=l(),p(V.$$.fragment),We=l(),p(A.$$.fragment),Be=l(),F=o("p"),F.innerHTML=Ct,Qe=l(),p(R.$$.fragment),Xe=l(),D=o("p"),D.innerHTML=yt,Ye=l(),p(O.$$.fragment),Ee=l(),p(K.$$.fragment),Ne=l(),p(ee.$$.fragment),Se=l(),te=o("p"),te.innerHTML=Mt,Ve=l(),p(ie.$$.fragment),Ae=l(),ne=o("p"),ne.textContent=Tt,Fe=l(),p(le.$$.fragment),Re=l(),oe=o("p"),this.h()},l(e){const t=Jt("svelte-u9bgzb",document.head);h=s(t,"META",{name:!0,content:!0}),t.forEach(i),se=a(e),ae=s(e,"P",{}),xt(ae).forEach(i),re=a(e),m(g.$$.fragment,e),pe=a(e),m(z.$$.fragment,e),me=a(e),w=s(e,"P",{"data-svelte-h":!0}),r(w)!=="svelte-1i43de8"&&(w.innerHTML=tt),ue=a(e),C=s(e,"P",{"data-svelte-h":!0}),r(C)!=="svelte-dxfjab"&&(C.textContent=it),ce=a(e),y=s(e,"P",{"data-svelte-h":!0}),r(y)!=="svelte-k47ujn"&&(y.textContent=nt),de=a(e),M=s(e,"P",{"data-svelte-h":!0}),r(M)!=="svelte-1ljj0xp"&&(M.textContent=lt),fe=a(e),T=s(e,"P",{"data-svelte-h":!0}),r(T)!=="svelte-zkvyxj"&&(T.innerHTML=at),ve=a(e),m(x.$$.fragment,e),he=a(e),P=s(e,"P",{"data-svelte-h":!0}),r(P)!=="svelte-1k0hbes"&&(P.textContent=ot),$e=a(e),j=s(e,"P",{"data-svelte-h":!0}),r(j)!=="svelte-1p8csib"&&(j.innerHTML=st),be=a(e),_=s(e,"P",{"data-svelte-h":!0}),r(_)!=="svelte-1y6gk5e"&&(_.textContent=rt),ge=a(e),$=s(e,"DIV",{class:!0,"data-svelte-h":!0}),r($)!=="svelte-1mpe2rl"&&($.innerHTML=pt),ze=a(e),L=s(e,"P",{"data-svelte-h":!0}),r(L)!=="svelte-196eb09"&&(L.innerHTML=mt),we=a(e),m(H.$$.fragment,e),Ce=a(e),J=s(e,"P",{"data-svelte-h":!0}),r(J)!=="svelte-1a2l4cc"&&(J.textContent=ut),ye=a(e),m(k.$$.fragment,e),Me=a(e),b=s(e,"DIV",{class:!0,"data-svelte-h":!0}),r(b)!=="svelte-1cj51wg"&&(b.innerHTML=ct),Te=a(e),I=s(e,"P",{"data-svelte-h":!0}),r(I)!=="svelte-qm2qt3"&&(I.innerHTML=dt),xe=a(e),m(G.$$.fragment,e),Pe=a(e),q=s(e,"P",{"data-svelte-h":!0}),r(q)!=="svelte-x2u2xi"&&(q.textContent=ft),je=a(e),m(U.$$.fragment,e),_e=a(e),Z=s(e,"P",{"data-svelte-h":!0}),r(Z)!=="svelte-1vi6p3e"&&(Z.innerHTML=vt),Le=a(e),W=s(e,"P",{"data-svelte-h":!0}),r(W)!=="svelte-1uk742v"&&(W.innerHTML=ht),He=a(e),B=s(e,"P",{"data-svelte-h":!0}),r(B)!=="svelte-swa0xa"&&(B.innerHTML=$t),Je=a(e),Q=s(e,"P",{"data-svelte-h":!0}),r(Q)!=="svelte-1wcffaj"&&(Q.innerHTML=bt),ke=a(e),X=s(e,"P",{"data-svelte-h":!0}),r(X)!=="svelte-1sxjkda"&&(X.innerHTML=gt),Ie=a(e),m(Y.$$.fragment,e),Ge=a(e),E=s(e,"P",{"data-svelte-h":!0}),r(E)!=="svelte-1cqowx9"&&(E.innerHTML=zt),qe=a(e),m(N.$$.fragment,e),Ue=a(e),S=s(e,"P",{"data-svelte-h":!0}),r(S)!=="svelte-1i6mnx2"&&(S.innerHTML=wt),Ze=a(e),m(V.$$.fragment,e),We=a(e),m(A.$$.fragment,e),Be=a(e),F=s(e,"P",{"data-svelte-h":!0}),r(F)!=="svelte-hnl8kv"&&(F.innerHTML=Ct),Qe=a(e),m(R.$$.fragment,e),Xe=a(e),D=s(e,"P",{"data-svelte-h":!0}),r(D)!=="svelte-1hovdlo"&&(D.innerHTML=yt),Ye=a(e),m(O.$$.fragment,e),Ee=a(e),m(K.$$.fragment,e),Ne=a(e),m(ee.$$.fragment,e),Se=a(e),te=s(e,"P",{"data-svelte-h":!0}),r(te)!=="svelte-1vxcxk4"&&(te.innerHTML=Mt),Ve=a(e),m(ie.$$.fragment,e),Ae=a(e),ne=s(e,"P",{"data-svelte-h":!0}),r(ne)!=="svelte-1tjnpeu"&&(ne.textContent=Tt),Fe=a(e),m(le.$$.fragment,e),Re=a(e),oe=s(e,"P",{}),xt(oe).forEach(i),this.h()},h(){Oe(h,"name","hf:doc:metadata"),Oe(h,"content",Ut),Oe($,"class","flex justify-center"),Oe(b,"class","flex justify-center")},m(e,t){kt(document.head,h),n(e,se,t),n(e,ae,t),n(e,re,t),u(g,e,t),n(e,pe,t),u(z,e,t),n(e,me,t),n(e,w,t),n(e,ue,t),n(e,C,t),n(e,ce,t),n(e,y,t),n(e,de,t),n(e,M,t),n(e,fe,t),n(e,T,t),n(e,ve,t),u(x,e,t),n(e,he,t),n(e,P,t),n(e,$e,t),n(e,j,t),n(e,be,t),n(e,_,t),n(e,ge,t),n(e,$,t),n(e,ze,t),n(e,L,t),n(e,we,t),u(H,e,t),n(e,Ce,t),n(e,J,t),n(e,ye,t),u(k,e,t),n(e,Me,t),n(e,b,t),n(e,Te,t),n(e,I,t),n(e,xe,t),u(G,e,t),n(e,Pe,t),n(e,q,t),n(e,je,t),u(U,e,t),n(e,_e,t),n(e,Z,t),n(e,Le,t),n(e,W,t),n(e,He,t),n(e,B,t),n(e,Je,t),n(e,Q,t),n(e,ke,t),n(e,X,t),n(e,Ie,t),u(Y,e,t),n(e,Ge,t),n(e,E,t),n(e,qe,t),u(N,e,t),n(e,Ue,t),n(e,S,t),n(e,Ze,t),u(V,e,t),n(e,We,t),u(A,e,t),n(e,Be,t),n(e,F,t),n(e,Qe,t),u(R,e,t),n(e,Xe,t),n(e,D,t),n(e,Ye,t),u(O,e,t),n(e,Ee,t),u(K,e,t),n(e,Ne,t),u(ee,e,t),n(e,Se,t),n(e,te,t),n(e,Ve,t),u(ie,e,t),n(e,Ae,t),n(e,ne,t),n(e,Fe,t),u(le,e,t),n(e,Re,t),n(e,oe,t),De=!0},p:jt,i(e){De||(c(g.$$.fragment,e),c(z.$$.fragment,e),c(x.$$.fragment,e),c(H.$$.fragment,e),c(k.$$.fragment,e),c(G.$$.fragment,e),c(U.$$.fragment,e),c(Y.$$.fragment,e),c(N.$$.fragment,e),c(V.$$.fragment,e),c(A.$$.fragment,e),c(R.$$.fragment,e),c(O.$$.fragment,e),c(K.$$.fragment,e),c(ee.$$.fragment,e),c(ie.$$.fragment,e),c(le.$$.fragment,e),De=!0)},o(e){d(g.$$.fragment,e),d(z.$$.fragment,e),d(x.$$.fragment,e),d(H.$$.fragment,e),d(k.$$.fragment,e),d(G.$$.fragment,e),d(U.$$.fragment,e),d(Y.$$.fragment,e),d(N.$$.fragment,e),d(V.$$.fragment,e),d(A.$$.fragment,e),d(R.$$.fragment,e),d(O.$$.fragment,e),d(K.$$.fragment,e),d(ee.$$.fragment,e),d(ie.$$.fragment,e),d(le.$$.fragment,e),De=!1},d(e){e&&(i(se),i(ae),i(re),i(pe),i(me),i(w),i(ue),i(C),i(ce),i(y),i(de),i(M),i(fe),i(T),i(ve),i(he),i(P),i($e),i(j),i(be),i(_),i(ge),i($),i(ze),i(L),i(we),i(Ce),i(J),i(ye),i(Me),i(b),i(Te),i(I),i(xe),i(Pe),i(q),i(je),i(_e),i(Z),i(Le),i(W),i(He),i(B),i(Je),i(Q),i(ke),i(X),i(Ie),i(Ge),i(E),i(qe),i(Ue),i(S),i(Ze),i(We),i(Be),i(F),i(Qe),i(Xe),i(D),i(Ye),i(Ee),i(Ne),i(Se),i(te),i(Ve),i(Ae),i(ne),i(Fe),i(Re),i(oe)),i(h),f(g,e),f(z,e),f(x,e),f(H,e),f(k,e),f(G,e),f(U,e),f(Y,e),f(N,e),f(V,e),f(A,e),f(R,e),f(O,e),f(K,e),f(ee,e),f(ie,e),f(le,e)}}}const Ut='{"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 Zt(et){return _t(()=>{new URLSearchParams(window.location.search).get("fw")}),[]}class Yt extends Lt{constructor(h){super(),Ht(this,h,Zt,qt,Pt,{})}}export{Yt as component};