当前位置：首页 > ai >正文

Gradio项目部署到魔搭创空间

ai 2025/7/22 5:38:19

作者：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 grdef 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：

使用阿里云账号或手机号注册/登录
点击右上角「创建项目」
选择「Gradio Web App 项目」模板

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

🗂️ 三、上传项目文件

你有两种方式上传代码：

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

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

压缩时 不要包含最外层的文件夹
app.py、requirements.txt 必须在 zip 根目录下

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

然后上传 memchain.zip 到魔搭。

✅ 方法二：通过 Git 绑定

将项目上传至 GitHub 或 Gitee
在魔搭平台选择「从 Git 克隆项目」
填写仓库地址并绑定入口文件名（默认 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

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

问题描述	解决办法
`app.py` 找不到	改名主程序为 `app.py` 或配置 `deployspec`
缺少 `requirements.txt`	添加此文件，并写入所有依赖
中文字体乱码	上传 `simhei.ttf` 并在代码中用 `ImageFont.truetype` 引用
依赖库版本不兼容	确保版本正确，参考本地运行时的环境