$ pip install gradio ipykernel

基本概念和術(shù)語

$ ipython kernel install --user --name=gradio_tutorial
$ jupyter lab  # Start the lab

：

import gradio as gr
print(gr.__version__)
4.37.1

def greet(name):
   return f"Hello, {name}!"
demo = gr.Interface(
   fn=greet,
   inputs=['text'],
   outputs="text",
)
demo.launch()

接口

組件
1. ：輸入和輸出元素，例如文本框，圖像和音頻。到目前為止，有30多個(gè)內(nèi)置組件。 >函數(shù)
：python函數(shù)從輸入組件處理信息，並返回結(jié)果以輸出組件顯示。 >
2. 啟動(dòng)：啟動(dòng)您的Gradio應(yīng)用的方法。
>
3. 上面的，我們創(chuàng)建了一個(gè)迎接文本輸入並返回文本輸入的問候功能。因此，輸入和輸出組件在接口類中指定為文本。 最後，我們調(diào)用啟動(dòng)本地服務(wù)器的啟動(dòng)方法。為了使任何人使用UI，您可以將共享參數(shù)設(shè)置為true。這將啟動(dòng)SSH隧道並將Gradio應(yīng)用程序部署到可公開共享的網(wǎng)頁：>
gradio組件
4. >您將花費(fèi)大部分時(shí)間在不同的組件上修補(bǔ)不同的組件，以及如何在構(gòu)建Gradio應(yīng)用程序時(shí)將它們放在頁面上。因此，讓我們仔細(xì)看看您可以使用的東西。 >

   >輸入和輸出組件

   Gradio提供了各種各樣的組件，用於構(gòu)建交互式接口。這些組件通常分為兩類：輸入和輸出。 >>

   >輸入組件允許用戶向基礎(chǔ)處理器提供數(shù)據(jù)（這可以是任何Python函數(shù)）。一些常見的輸入是：

   textbox
   • 圖像
   • 音頻
   • 滑塊
   • >下拉
   這是一個(gè)虛擬界面，使用上述某些組件：>
   在此示例中，process_inputs函數(shù)需要五個(gè)參數(shù)。因此，我們需要?jiǎng)?chuàng)建五個(gè)輸入組件並將其傳遞給輸入。雖然輸入組件的數(shù)量應(yīng)匹配所需功能參數(shù)的數(shù)量，但這不是嚴(yán)格的規(guī)則。為避免錯(cuò)誤和警告，請(qǐng)為不需要UI輸入的參數(shù)設(shè)置默認(rèn)值。

   $ conda create -n gradio_tutorial python=3.9 -y
   $ conda activate gradio_tutorial

   >注意我們?nèi)绾问褂梦谋究蝾悂碇付ㄝ斎虢M件，而不是像第一個(gè)示例那樣的普通字符串文本。始終建議使用專用類指定輸入和輸出組件以使其可自定義。例如，所有組件類都有一個(gè)有用的標(biāo)籤屬性，而滑塊和下拉列表都有指定範(fàn)圍和可用選項(xiàng)的參數(shù)。

   > >許多輸入組件也可用於顯示輸出。以下是一些常見的情況：

   標(biāo)籤：用於顯示文本或分類結(jié)果
   圖像：用於顯示已處理或生成的圖像
   • >音頻：用於播放處理或生成的音頻
   • 繪圖：用於顯示圖形或圖表
   >
   喜歡輸入，輸出組件的數(shù)量必須匹配從處理函數(shù)中返回值的數(shù)量。
   >自定義組件外觀

   Gradio允許您自定義組件的外觀以適應(yīng)您的需求。這是一個(gè)使用自定義文本框的示例：

   >

   $ pip install gradio ipykernel

   在此示例中，我們通過指定行數(shù)，添加佔(zhàn)位符和信息文本，並包括輸出的副本按鈕來自定義文本框組件。 >

   >實(shí)驗(yàn)不同的組件及其屬性，以創(chuàng)建最適合您AI應(yīng)用程序要求的接口。要了解可以更改組件的哪種屬性，您可以訪問其文檔，或者更好的是使用？ jupyter實(shí)驗(yàn)室的班級(jí)名稱之後：

   > llms

   的構(gòu)建界面

   >讓我們通過創(chuàng)建由LLMS供電的兩個(gè)現(xiàn)實(shí)世界文本和基於圖像的界面來將所有學(xué)到的一切放在一起。 。

   首先，我們將構(gòu)建從英語到土耳其語，西班牙語或中文的語言翻譯：

   $ conda create -n gradio_tutorial python=3.9 -y
   $ conda activate gradio_tutorial

   最初，我們定義一個(gè)translate_text函數(shù)。在其體內(nèi)，我們?cè)O(shè)置了OpenAI API鍵並創(chuàng)建語言圖。然後，我們構(gòu)建了翻譯的提示。然後，在一個(gè)try-except塊中，我們使用系統(tǒng)提示符將請(qǐng)求發(fā)送到聊天的端點(diǎn)。最後，我們返回首選。
   現(xiàn)在，我們可以構(gòu)建接口：>
   代碼很簡單，就像早期接口的代碼一樣，但是我們介紹了幾個(gè)新屬性：

   $ pip install gradio ipykernel

   >文本框的類型參數(shù)將普通文本輸入字段更改為密碼輸入，隱藏文本。
   • >標(biāo)題和描述界麵類的參數(shù)在頁面的頂部中心添加了H1標(biāo)題和字幕。
   這是結(jié)果：

   >您可能想知道為什麼我們要詢問用戶的API密鑰作為應(yīng)用程序的一部分，而不是自己提供。原因與Gradio如何部署UI有關(guān)。

   如果我們提供了自己的API密鑰作為環(huán)境變量（這是標(biāo)準(zhǔn)實(shí)踐），則公開共享的應(yīng)用程序版本將無法使用，因?yàn)樗鼰o法訪問我們的環(huán)境變量。在部署部分中，我們將通過將應(yīng)用程序部署到擁抱面空間來查看如何解決此問題。
   >讓我們構(gòu)建另一個(gè)用戶界面以生成圖像：

   我們創(chuàng)建一個(gè)名為generate_surrealist_art的函數(shù)，該函數(shù)將請(qǐng)求發(fā)送到dall-e-3，並使用超現(xiàn)實(shí)主義提示返回生成的圖像URL。然後，我們將再次將此函數(shù)饋送到接口類中：

   >

   $ ipython kernel install --user --name=gradio_tutorial
   $ jupyter lab  # Start the lab

   >我們?yōu)锳PI密鑰指定了兩個(gè)輸入，以及要在超現(xiàn)實(shí)主義圖像中捕獲的概念。然後，我們使用圖像類創(chuàng)建一個(gè)生成圖像的輸出組件。如果將其值參數(shù)設(shè)置為str，則組件可以從URL下載和顯示圖像，這正是我們需要的。

   import gradio as gr
   print(gr.__version__)
   4.37.1

   ，這是結(jié)果：

   >構(gòu)建經(jīng)典ML模型的界面 現(xiàn)在，讓我們?yōu)榻?jīng)典表格回歸模型構(gòu)建一個(gè)接口。我們將使用鑽石數(shù)據(jù)集，該數(shù)據(jù)集可在Seaborn中使用。

   首先創(chuàng)建一個(gè)新的工作目錄和一個(gè)名為app.py的新腳本。然後，將加載數(shù)據(jù)加載的GitHub Gist的代碼粘貼，使用Scikit-Learn管道處理並訓(xùn)練RandomForestRegress模型。
   下一步是創(chuàng)建一個(gè)處理功能，該功能接受與鑽石數(shù)據(jù)集中有功能相同數(shù)量的輸入：

   $ conda create -n gradio_tutorial python=3.9 -y
   $ conda activate gradio_tutorial

   >該函數(shù)將這些輸入轉(zhuǎn)換為數(shù)據(jù)框，並將其傳遞到訓(xùn)練有素的模型管道的.predict（）方法。最後，它返回一個(gè)帶有預(yù)測價(jià)格的字符串。

   現(xiàn)在，接口類必須匹配此函數(shù)的簽名：用於處理功能的九個(gè)輸入組件和一個(gè)用於顯示預(yù)測價(jià)格的輸出：

   $ pip install gradio ipykernel

   在班級(jí)內(nèi)，我們?yōu)榉诸惞δ軇?chuàng)建了三個(gè)下拉列表。每個(gè)功能中的唯一類別都填充了這些選項(xiàng)。我們還創(chuàng)建了六個(gè)滑塊組件以接受數(shù)字功能?；瑝K的範(fàn)圍取決於每個(gè)特徵的最小值和最大值。

   >我們現(xiàn)在要做的就是執(zhí)行腳本以運(yùn)行和部署應(yīng)用程序：>
   這是結(jié)果：

   $ ipython kernel install --user --name=gradio_tutorial
   $ jupyter lab  # Start the lab

   >有關(guān)最佳實(shí)踐和優(yōu)化提示，請(qǐng)?zhí)料旅娴淖罴褜?shí)踐部分。

   >部署Gradio應(yīng)用
   >我們已經(jīng)看到通過啟用一個(gè)參數(shù)來部署Gradio應(yīng)用程序的容易。當(dāng)然，這種方法的缺點(diǎn)是演示可以在72小時(shí)內(nèi)到期。因此，推薦的部署Gradio的方法是通過擁抱面空間。 Huggingface於2021年獲得了Gradio，使兩個(gè)平臺(tái)之間的集成無縫。 因此，對(duì)於本教程或您使用Gradio創(chuàng)建的任何未來應(yīng)用程序，請(qǐng)?jiān)趆uggingface.co上註冊(cè)一個(gè)免費(fèi)帳戶，然後導(dǎo)航到設(shè)置＆gt;代幣生成訪問令牌：

   >

   令牌僅顯示一次，因此請(qǐng)確保將其存儲(chǔ)在安全的地方。

   >使用此令牌，您可以在空間上永久託管時(shí)盡可能多地部署想要的級(jí)別應(yīng)用程序。例如，我們將從上一節(jié)中部署鑽石價(jià)格預(yù)測模型，您會(huì)發(fā)現(xiàn)它非常容易。

   > 您所要做的就是使用UI腳本導(dǎo)航到目錄，並在終端上調(diào)用Gradio部署：>

   >終端使您通過將腳本轉(zhuǎn)換為功能正常的擁抱面空間。它要求諸如：

   之類的詳細(xì)信息
   您生成的訪問令牌

   >空間標(biāo)題：這將是部署後空間URL的一部分

   包含gradio ui代碼（app.py默認(rèn)值）的腳本的名稱

   >
   >空間的硬件；空白以使用CPU（免費(fèi)）
   任何腳本使用的任何環(huán)境變量（這是您安全存儲(chǔ)API密鑰和用戶秘密的位置）
   • >
   依賴項(xiàng) - 通過按Enter 一個(gè)一個(gè)一個(gè)接一個(gè)地輸入
   >終端為您提供了部署的空間鏈接。這是它的外觀：
   關(guān)於這種部署方法的另一個(gè)好處是，Gradio會(huì)自動(dòng)將演示轉(zhuǎn)換為工作的REST API。訪問和查詢的說明始終位於底部：

   >

   

   因此，一口氣，您既有用於非技術(shù)用戶申請(qǐng)的永久UI託管，又有為同事和開發(fā)人員朋友的REST API。

   >有關(guān)更多部署和共享選項(xiàng)，例如將演示嵌入網(wǎng)頁中，將Google Authentication添加到應(yīng)用程序等，請(qǐng)?jiān)L問Gradio文檔的“共享您的應(yīng)用程序”部分。

   gradio最佳實(shí)踐和技巧

   >

   在使用Gradio開髮用戶界面時(shí)，遵循最佳實(shí)踐可以顯著提高應(yīng)用程序的用戶體驗(yàn)和可維護(hù)性。以下是一些關(guān)鍵建議：
   1。將腳本用於組織和可維護(hù)性

   >

   >在Python腳本中組織Gradio應(yīng)用程序，以進(jìn)行更好的版本控制，協(xié)作和部署。

   >

   2。優(yōu)化組件的空間分配
   >使用適當(dāng)?shù)某叽绾蛠丫止ぞ撸ɡ纾琯r.column（），gr.row（））來確保平衡，響應(yīng)式接口。

   3。提供全面的信息

   >利用“信息”和“標(biāo)籤”屬性為每個(gè)組件提供清晰的說明和上下文。

   4。有效地處理大型功能集

   對(duì)於具有多個(gè)功能的模型，請(qǐng)使用文件輸入（CSV，JSON）啟用批處理預(yù)測並簡化接口。

   5。正確管理環(huán)境變量

   >使用python-dotenv進(jìn)行本地開發(fā)，並將變量設(shè)置在擁抱面部空間以進(jìn)行部署。

   6。實(shí)施錯(cuò)誤處理和驗(yàn)證
   >驗(yàn)證輸入，提供明確的錯(cuò)誤消息，並使用Try-Except塊進(jìn)行正式錯(cuò)誤處理。
   7。優(yōu)化性能
   >實(shí)現(xiàn)緩存，大型型號(hào)的懶惰加載，並使用Gr.LoadingStatus（）進(jìn)行長期運(yùn)行的任務(wù)。
   8?？稍L問性的設(shè)計(jì)

   確保高對(duì)比度，為圖像提供ALT文本，並為所有交互式元素啟用鍵盤導(dǎo)航。

   9。實(shí)施漸進(jìn)披露

   >使用手風(fēng)琴或選項(xiàng)卡來組織複雜的接口，根據(jù)需要揭示高級(jí)選項(xiàng)。 >

   10。定期更新並維護(hù)
   >保持依賴關(guān)係更新，監(jiān)視錯(cuò)誤並根據(jù)用戶反饋不斷改進(jìn)。
   11。利用擁抱面資源
   >利用擁抱面工具和資源與Gradio無縫集成，包括模型存儲(chǔ)庫和數(shù)據(jù)集。
   12。在擁抱面樞紐

   上託管大型型號(hào)

   >對(duì)於大型表格模型，上傳到擁抱面式集線器並直接在Gradio腳本中加載，以提高性能並減少本地存儲(chǔ)要求。

   13。利用擁抱面數(shù)據(jù)集

   對(duì)於大型數(shù)據(jù)集，上傳到HuggingFace Hub，然後直接在您的Gradio應(yīng)用程序中訪問它們以簡化數(shù)據(jù)管理並改善加載時(shí)間。

   結(jié)論和進(jìn)一步的資源

   在本文中，我們了解了使用Gradio為AI應(yīng)用程序構(gòu)建用戶界面的基礎(chǔ)知識(shí)。我們剛剛在表面下方傾斜，因?yàn)镚radio為構(gòu)建複雜界面提供了更多功能。例如，接口狀態(tài)允許您的應(yīng)用程序記住從一個(gè)函數(shù)調(diào)用到另一個(gè)函數(shù)的輸出。用戶輸入更改後，反應(yīng)性接口會(huì)動(dòng)態(tài)更改UI。使用塊，您可以構(gòu)建具有自定義佈局和設(shè)計(jì)的應(yīng)用程序。

   同樣，請(qǐng)查看這些相關(guān)資源以獲取更多內(nèi)容：

   10個(gè)python軟件包添加到您的數(shù)據(jù)科學(xué)堆棧
   • 7個(gè)基本的生成AI工具，用於構(gòu)建出色的AI應(yīng)用程序
   5個(gè)項(xiàng)目，您可以使用Gen AI模型
   • 構(gòu)建
   CI/CD用於機(jī)器學(xué)習(xí)課程