ShortGPT

环境要求

• 已安装 Docker（README 明确指出本地运行必须依赖 Docker）
• 项目根目录下存在 .env 环境变量文件（具体键名需参考 installation-notes.md）
• 构建镜像时可联网下载依赖（Python 包等）
• 或改用官方 Google Colab，免费且无需本地安装

安装与启动步骤

1. 1克隆项目代码

   把 ShortGPT 仓库拉到本地并进入目录；README 正文未直接给出该命令，是按仓库地址推断的。

   git clone https://github.com/RayVentura/ShortGPT.git
   cd ShortGPT

   复制

2. 2准备 .env 文件

   在项目根目录创建 .env，填入所需环境变量；README 未列出具体键名，请看 installation-notes.md。

   cp .env.example .env

   复制

3. 3构建 Docker 镜像

   在项目根目录执行，镜像名固定为 short_gpt_docker:latest，构建过程会联网拉取依赖。

   docker build -t short_gpt_docker:latest .

   复制

4. 4启动容器

   用 --env-file 载入 .env，把容器 31415 端口映射到本机 31415 端口。

   docker run -p 31415:31415 --env-file .env short_gpt_docker:latest

   复制

5. 5打开 Web 界面

   容器启动后会运行 runShortGPT.py，在本机 31415 端口拉起 Gradio 界面。

6. 6改用 Google Colab

   不想本地装环境可直接用官方 Colab 笔记本，点击单元格 Play 按钮从上到下依次运行。

关键配置

如何确认成功

浏览器打开 http://localhost:31415，能看到 Gradio 界面即说明启动成功。

常见问题

注意事项

• README 强烈推荐使用 Google Colab 运行，本地安装仅作为可选方案。
• README 多次提示阅读 installation-notes.md 了解安装细节，遇到问题应优先查看该文件。
• 端口 31415 来自官方 docker run 命令，不要随意改动映射关系。
• git clone 命令与 cp .env.example .env 为便于操作的通用准备动作，README 正文未直接给出，实际文件名以仓库内容为准。