NLP 课程文档

构建你的第一个演示

Hugging Face's logo
加入 Hugging Face 社区

并获取增强文档体验

开始吧

构建你的第一个演示

Ask a Question Open In Colab Open In Studio Lab

让我们从安装 Gradio 开始!由于它是一个 Python 包,只需运行

$ pip install gradio

你可以在任何地方运行 Gradio,无论是从你最喜欢的 Python IDE,到 Jupyter 笔记本,甚至在 Google Colab 🤯 中!因此,在任何你运行 Python 的地方安装 Gradio!

让我们从一个简单的“Hello World”示例开始,以便熟悉 Gradio 语法

import gradio as gr


def greet(name):
    return "Hello " + name


demo = gr.Interface(fn=greet, inputs="text", outputs="text")

demo.launch()

让我们逐步分析上面的代码

  • 首先,我们定义一个名为 greet() 的函数。在这种情况下,它是一个简单的函数,在你的姓名之前添加“Hello”,但它通常可以是任何 Python 函数。例如,在机器学习应用中,此函数将调用模型对输入进行预测并返回输出。
  • 然后,我们使用三个参数 fninputsoutputs 创建一个 Gradio Interface。这些参数定义了预测函数,以及我们想要的输入和输出组件的类型。在本例中,两个组件都是简单的文本框。
  • 然后,我们对创建的 Interface 调用 launch() 方法。

如果你运行此代码,下面的界面将自动显示在 Jupyter/Colab 笔记本中,或者如果从脚本运行,则会弹出浏览器上的 http://localhost:7860

现在,尝试使用你自己的姓名或其他一些输入来使用这个 GUI!

你会注意到,在这个 GUI 中,Gradio 自动推断出输入参数的名称 (name),并将其作为标签应用在文本框顶部。如果你想更改它怎么办?或者如果你想以其他方式自定义文本框?在这种情况下,你可以实例化一个表示输入组件的类对象。

查看下面的示例

import gradio as gr


def greet(name):
    return "Hello " + name


# We instantiate the Textbox class
textbox = gr.Textbox(label="Type your name here:", placeholder="John Doe", lines=2)

gr.Interface(fn=greet, inputs=textbox, outputs="text").launch()

在这里,我们创建了一个带有标签、占位符和固定行数的输入文本框。你可以对输出文本框执行相同的操作,但我们现在先不进行操作。

我们已经看到,仅需几行代码,Gradio 就可以让你围绕任何带有任何类型输入或输出的函数创建一个简单的界面。在本节中,我们从一个简单的文本框开始,但在接下来的部分中,我们将介绍其他类型的输入和输出。现在,让我们来看看如何在 Gradio 应用程序中包含一些 NLP。

🤖 包含模型预测

现在,让我们构建一个简单的界面,让你可以演示文本生成模型,例如 GPT-2。

我们将使用 🤗 Transformers 中的 pipeline() 函数加载我们的模型。如果你需要快速复习,可以返回到 第一章的那一节

首先,我们定义一个预测函数,它接收一个文本提示并返回文本补全

from transformers import pipeline

model = pipeline("text-generation")


def predict(prompt):
    completion = model(prompt)[0]["generated_text"]
    return completion

此函数将完成你提供的提示,你可以使用你自己的输入提示来运行它,看看它是如何工作的。这是一个示例(你可能会得到不同的补全)

predict("My favorite programming language is")
>> My favorite programming language is Haskell. I really enjoyed the Haskell language, but it doesn't have all the features that can be applied to any other language. For example, all it does is compile to a byte array.

现在我们有了用于生成预测的函数,我们可以像之前一样创建和启动一个 Interface

import gradio as gr

gr.Interface(fn=predict, inputs="text", outputs="text").launch()

就是这样!你现在可以使用此界面使用 GPT-2 模型生成文本,如下所示 🤯。

继续阅读以了解如何使用 Gradio 构建其他类型的演示!