如何为 Gradio 创建独立 Python 虚拟环境并完成安装验证

📅 发布时间:2026/9/10 7:34:06
如何为 Gradio 创建独立 Python 虚拟环境并完成安装验证
如何为 Gradio 创建独立 Python 虚拟环境并完成安装验证【免费下载链接】gradioBuild and share delightful machine learning apps, all in Python. Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/gr/gradio这篇文章解决的问题是在 Windows 或 MacOS/Linux 上如何为 Gradio 搭建一个与系统 Python 隔离的独立虚拟环境完成 Gradio 安装并通过导入验证确认版本。官方指南 Installing Gradio in a Virtual Environment 覆盖了 Windows 与 MacOS/Linux 两套完整命令Quickstart 则确认了前置要求Gradio 需要 Python 3.10 或更高版本。Python 虚拟环境是一个自包含的目录持有特定版本 Python 的一套独立安装包与主 Python 安装及其他虚拟环境相互隔离。这样不同项目可以使用不同版本的依赖而不互相冲突也便于把项目依赖分享出去。官方建议安装 Gradio 时就放在虚拟环境里这也是本文的主路径。准备条件确认 Python 版本两条平台路径的共同前置条件是 Python 3.10 或更高。Windows在 Command Prompt 中运行python --version或python3 --version验证。文档说明 Python 可从其官方网站python.org下载。MacOS/LinuxPython 通常已预装在终端运行python --version验证。注意取决于 Python 的安装方式后续所有步骤中的python可能需要换成python3。版本不足时同样从官方网站下载 Python 3.10 或更高版本。Windows创建虚拟环境并安装 Gradio创建虚拟环境。打开 Command Prompt进入你的项目目录然后执行python -m venv gradio-env这会在项目文件夹中创建目录gradio-env其中包含一套全新的 Python 安装。gradio-env只是示例名称你可以换成其他名字。激活虚拟环境.\gradio-env\Scripts\activate激活后命令行提示符应显示当前处于gradio-env环境中这是判断下一步可以执行的依据。安装 Gradiopip install gradioQuickstart 文档中给出的命令是pip install --upgrade gradio适合已安装过 Gradio 的场景用于升级到新版本全新安装用上面的pip install gradio即可。验证安装。运行python进入解释器然后输入import gradio as gr print(gr.__version__)如果安装成功这里会打印出已安装的 Gradio 版本号。具体版本数字取决于安装时 PyPI 上的最新版本文档未固定某个值因此以你实际打印出的结果为准。MacOS/Linux创建虚拟环境并安装 Gradio命令与 Windows 基本一致差异在于激活方式。创建虚拟环境。打开 Terminal进入项目目录python -m venv gradio-env环境目录名可以自定义。如果你的系统里python不可用改用python3 -m venv gradio-env文档已提示 MacOS/Linux 上可能需要python3。激活虚拟环境source gradio-env/bin/activate安装 Gradiopip install gradio验证安装。与 Windows 相同import gradio as gr print(gr.__version__)能正常导入并打印版本号说明虚拟环境中的 Gradio 安装完成。安装验证通过后的下一步跑第一个应用Quickstart 文档给出了安装后的首个可执行示例。把下面的代码保存为app.py代码来自仓库内 demo/hello_world_4/run.pyimport gradio as gr def greet(name, intensity): return Hello, name ! * int(intensity) demo gr.Interface( fngreet, inputs[text, slider], outputs[text], api_namepredict ) if __name__ __main__: demo.launch()在激活的虚拟环境中从终端运行python app.py。文档说明从文件方式运行时演示页面会在浏览器打开 http://localhost:7860在 notebook 中运行时页面则嵌入在 notebook 内。在左侧文本框输入名字、拖动滑块、按下 Submit右侧应出现对应的问候语。开发期间还有一个可选的加速方式把python换成gradio命令运行文件例如gradio app.py即可开启热重载文件每次被修改时应用自动重新加载再加--vibe标志如gradio --vibe app.py可启用 vibe 模式。限制与注意事项平台差异只有两处需要留意Windows 的激活命令是.\gradio-env\Scripts\activateMacOS/Linux 是source gradio-env/bin/activateMacOS/Linux 上可能需要全程用python3代替python。验证方式就是print(gr.__version__)能否打印版本号文档没有提供其他验证命令如果导入报错说明该环境中的安装尚未成功应回到pip install gradio步骤检查。本文只覆盖虚拟环境内的安装与验证共享演示launch(shareTrue)、gr.Blocks等进阶内容在 Quickstart 指南中有进一步介绍不属于本场景。【免费下载链接】gradioBuild and share delightful machine learning apps, all in Python. Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/gr/gradio创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考