speechgpt

环境要求

• 已安装 Docker 环境（可执行 docker 命令）
• 一个可用的 OpenAI API Key
• 支持麦克风的现代浏览器并允许录音权限
• 能访问 Docker Hub 拉取镜像的网络环境

安装与启动步骤

1. 1拉取镜像

   从 Docker Hub 拉取官方镜像 hahahumble/speechgpt，README 标注该镜像为 arm64 架构，其他架构请留意兼容性。

   docker pull hahahumble/speechgpt

   复制

2. 2启动容器

   后台运行容器并把容器 8080 端口映射到本机 8080，容器命名为 speechgpt，方便后续管理。

   docker run -d -p 8080:8080 --name speechgpt hahahumble/speechgpt

   复制

3. 3访问应用

   在浏览器打开 http://localhost:8080/ ，能看到 SpeechGPT 界面即部署成功。

4. 4配置 API Key

   进入 Settings 设置页，在 Chat 相关配置中填入 OpenAI API Key，保存后才能正常对话。

5. 5源码构建镜像

   如需自行构建，先克隆项目到本地，在项目根目录用 Dockerfile 构建镜像，再运行容器。

   git clone https://github.com/hahahumble/speechgpt.git
   cd speechgpt
   docker build -t speechgpt:arm64 -f Dockerfile .
   docker run -d -p 8080:8080 --name=speechgpt speechgpt

   复制

关键配置

如何确认成功

浏览器访问 http://localhost:8080/ 能正常打开应用界面，并在 Settings 保存 API Key 后完成一次语音对话。

常见问题

注意事项

• 所有数据存储在本地，隐私性较好，但 API Key 也保存在浏览器本地，请勿在公共设备上填写。
• 语音识别与语音合成支持浏览器内置能力，也支持 Azure Speech Services、Amazon Polly 等外部服务，按需在设置中切换。
• README 的 Vercel 部署章节没有给出具体命令，本教程未做推测。
• 初次使用需授权浏览器麦克风权限，否则无法录音。