项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2347
使用教程
环境要求
- 已安装并启动 Docker(Docker Desktop 或 Docker Engine)
- 能访问 ghcr.io 拉取镜像
- 本机 3000 端口空闲
- 一个 OpenAI API 密钥(ChatGPT API)
- 可选:ElevenLabs 账号用于真人语音
安装与启动步骤
-
1安装 Docker
项目官方推荐用 Docker 自托管运行,需先在电脑上装好 Docker 并保持运行。
-
2启动容器
挂载当前目录 data 保存数据,映射 3000 端口;首次执行会自动拉取镜像。
docker run -v $(pwd)/data:/app/data -p 3000:3000 ghcr.io/cogentapps/chat-with-gpt:release -
3打开 Web 界面
在浏览器访问 http://localhost:3000 即可看到聊天界面。
-
4配置 API 密钥
进入应用后填入自带的 OpenAI 密钥;想要真人语音可再连接 ElevenLabs 账号。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OpenAI API Key | 是 | 调用 ChatGPT API 生成回复,需自行到 OpenAI 申请 | sk-xxxxxxxx |
ElevenLabs API Key | 否 | 接入后回复由 ElevenLabs 朗读,不填则用浏览器内置语音 | your-elevenlabs-key |
端口映射 -p | 是 | 把宿主端口映射到容器 3000,左侧端口冲突时可改 | 3000:3000 |
如何确认成功
浏览器能打开 http://localhost:3000 并显示聊天界面,发送一条消息能收到 GPT 回复即成功。
常见问题
Q:没有 API 密钥能用吗?
A:不能。应用需要自带 OpenAI 密钥来调用 ChatGPT API;ElevenLabs 语音密钥是可选的,也可以改用浏览器内置的文本转语音。
Q:聊天记录会丢吗?
A:命令把宿主机的 data 目录挂载到容器 /app/data,只要保留该目录,删掉容器后数据仍在。
Q:有不用自己部署的版本吗?
A:有,官方提供了托管版本 https://www.chatwithgpt.ai,可直接在线体验。
Q:语音是怎么实现的?
A:连接 ElevenLabs 账号可让 ChatGPT 拥有拟人语音,不连接时使用浏览器自带语音合成;语音识别由 OpenAI Whisper 驱动。
注意事项
- 命令中的 $(pwd) 在 Windows PowerShell 下不适用,请在 Git Bash/WSL 中执行,或换成宿主机绝对路径。
- 镜像 tag 为 release,升级时重新拉取该镜像并重建容器即可。
- 需能正常访问 ghcr.io,网络受限时建议配置镜像加速或代理。
核心亮点
- 集成语音识别与合成,实现完整的语音对话闭环
- 支持自定义 API 密钥,数据私密可控
- 基于 TypeScript,代码结构清晰,易于二次开发
不足之处
- 依赖 OpenAI API,需要付费密钥才能使用
- 语音识别准确率受环境噪音影响,嘈杂场景体验下降
- 文档/社区待观察
适用场景
- 个人语音助手,解放双手进行问答
- 无障碍场景,帮助视障用户使用 ChatGPT
- 教育场景,通过语音互动练习外语对话
替代项目
voice-gpt、chatgpt-voice、openai-whisper
上一篇:oterm
下一篇:no-cost-ai
同类项目推荐
cv4pve-botgram
开源
手机发条消息,就能管好 Proxmox 集群
Telegram bot to manage and monitor Proxmox VE from your mobile
leon-cli
开源
在终端里唤起你的 AI 助手,命令行直接对话
⌨️ Command-line interface (CLI) for a better use of Leon, your open-source persona···
Llama-macOS
开源
Mac 上双击就能跑的本地大模型聊天应用
A cosy home for your LLMs.
ChatGPT-Telegram-Bot
开源
在 Telegram 里一个机器人搞定 GPT、Gemini、Claude,还能联网搜索和画图
TeleChat: ️ an AI chat Telegram bot can Web Search Powered by GPT-5, DALL·E , Groq···
sveltekit-ai-chatbot
开源
SvelteKit 聊天机器人模板,改改就能上线
A full-featured, hackable SvelteKit AI chatbot
OwnGPT
开源
本地跑起专属GPT,文档问答不泄密
Create Own ChatGPT with your documents using streamlit UI on your own device using G···
MiraiAndroid
开源
在安卓手机上直接跑QQ机器人,免电脑部署
QQ机器人 /(实验性)在Android上运行Mirai-console,支持插件
Jarvis-Desktop-Voice-Assistant
开源
动嘴就能操控电脑,语音执行系统命令
A python based desktop voice assistant capable of executing system-level commands, i···
KeepChatGPT
开源
让 ChatGPT 不掉线、更安全,聊天丝滑又高效
这是一款提高ChatGPT的数据安全能力和效率的插件。并且免费共享大量创新功能,如:自动刷新···
