Gradio项目部署到魔搭创空间

作者：Charlotte｜ 时间：2025-07-21
标签：Gradio、ModelScope、魔搭、AI 应用部署、低代码平台

🌟 前言

你是否已经用 Gradio 打造了一个漂亮的 AI 应用，但不知道该如何部署上线供他人访问？今天我们将以阿里达摩院出品的 魔搭创空间（ModelScope Studio） 为例，教你如何将本地的 Gradio 项目一键部署到云端，免费体验在线 AI 服务的乐趣！

📦 一、准备你的 Gradio 项目

我们以一个简单的 Gradio 应用为例，它包含以下目录结构：

memchain/
├── app.py              # 主程序（注意名字为 app.py）
├── requirements.txt    # Python 依赖
├── README.md           # 项目说明
└── simhei.ttf          # 中文字体（可选）

示例代码 app.py

import gradio as gr

def greet(name):
    return f"你好，{name}！欢迎使用 Gradio 项目。"

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

if __name__ == "__main__":
    demo.launch()

示例 requirements.txt

gradio==3.41.2

确保你能在本地执行：

python app.py

出现 http://127.0.0.1:7860 即表示无误。

☁️ 二、访问魔搭创空间

打开 ModelScope Studio：

1. 使用阿里云账号或手机号注册/登录

2. 点击右上角「创建项目」

3. 选择「Gradio Web App 项目」模板

1. 填写项目信息，如项目名称、简介、技术领域等

🗂️ 三、上传项目文件

你有两种方式上传代码：

✅ 方法一：上传 ZIP 包（推荐）

将项目根目录打包为 zip，注意：

• 压缩时 不要包含最外层的文件夹

• app.py、requirements.txt 必须在 zip 根目录下

cd memchain
zip -r ../memchain.zip *

然后上传 memchain.zip 到魔搭。

✅ 方法二：通过 Git 绑定

1. 将项目上传至 GitHub 或 Gitee

2. 在魔搭平台选择「从 Git 克隆项目」

3. 填写仓库地址并绑定入口文件名（默认 app.py）

✅ 方法三：手动添加文件

      1. 点击添加文件

      2. 可以选择上传或者创建文件

🛠️ 四、部署配置说明

启动文件要求

• 默认入口文件名为 app.py

• 如果你的主文件叫 main.py，可以：

  • 改名为 app.py（推荐）

  • 或在 README 开头加上：

    deployspec:
      entry_file: main.py
    

requirements.txt 缺失问题

如果日志提示：

/home/studio_service/PROJECT/requirements.txt does not exist, skip pip install_requirements.

说明你忘了上传 requirements.txt 文件，请确保它存在。

🚀 五、成功运行并访问

部署完成后，控制台会输出类似内容：

[INFO] Running on http://0.0.0.0:15181 (CTRL + C to quit)

然后你可以在魔搭界面点击「在线体验」，访问分配给你的 Gradio Web 地址，如：

https://modelscope.cn/webapp/your-username/your-project

🔍 六、部署失败的常见问题

🧠 七、写在最后

魔搭创空间极大地降低了 AI 应用部署的门槛，让开发者专注于模型和体验本身。如果你正在开发 Gradio 应用，不妨试试将它发布到 ModelScope，无需服务器、无需复杂 DevOps，只需几步配置，即可实现全网访问。

欢迎大家部署自己的疗愈机器人、图像增强工具、智能问答助手等，把你的创意变成现实！

📌 项目演示地址（示例）：
心灵疗愈空间

📮 联系我：
如有问题欢迎评论交流或私信提问～

这里是Charlotte，正在成为一名优秀的AI产品经理的路上~