写了几个月的项目终于差不多了,虽然还有关于手机端适配还没做完和更多作为相对深入的设置还没有写完但可以作为最小可行产品MVP了,基本构思的功能全部实现。
目的是把主流模型、文件/图片/语音处理、深度研究与 WebSocket 流式体验装进一个私有、可控的单用户工作台。同时也是作为多年前我个人对NextChatWeb(现NextChat)的一些不满意的点和吐槽点做一个了断。
项目仍在快速演进,接口与 UI 会持续调整。 目前仅为Openai,Anthropic,Gemini进行的完整的适配(指深度化提供商功能的适配),并且支持 OpenAI兼容 协议的模型(这块后续会进行针对OpenAI兼容提供商对于类似openai,anthropic独有原生功能的第三方开源方案的集成和适配),同时 云同步功能还没有开发完成这个后期会考虑是否具体上
MineChatWeb 是一个开源 AI 聊天平台,整合多个主流大语言模型,提供现代化的对话体验。项目采用 Python FastAPI 后端和 Next.js + TypeScript 前端架构。
强交互体验:原生 WebSocket 流式输出,有心跳保活;支持「推理过程可视化」(思考模型)。
统一入口:一套 UI 接多个厂商(OpenAI / Anthropic / Gemini / DeepSeek / Moonshot),切模型不换工具。
多模态与文件工作流:上传文档/代码/数据,三种处理模式(直读 / Code Interpreter / File Search);多图识别与语音转录。
深度研究模式:基于 Responses API 的检索-工具-搜索联动,适合做长链路的信息整理与结论产出。
隐私优先:密钥与配置仅存浏览器本地,不上服务端。
核心特性一览
- 多模型:OpenAI / Anthropic / Google Gemini / DeepSeek / Moonshot;可视化「模型市场」支持在线刷新配置。
- 文件处理:PDF/Office/代码/压缩包等,直读 / 代码执行 / 检索三种模式。
- 视觉与语音:多图上传与识别;Whisper/GPT-4o 转写。
- 插件与扩展:Function Calling 与 MCP 服务器。
- 现代前端:响应式、暗色模式、移动端适配。
技术栈
- 后端:FastAPI + WebSocket
- 前端:Next.js + TypeScript + Tailwind + Zustand
- 其他:Docker Compose / Node.js / Python 3.9+
快速部署
Docker Compose:
git clone https://github.com/marvinli001/MineChatWeb.git
cd MineChatWeb
docker compose up -d
# 前端: http://localhost:3000
# 后端: http://localhost:8000 (Swagger: /docs)
云端组合:前端 Vercel,后端 Railway(或同类平台),支持 CI/CD。
说明:仓库内含
DEPLOYMENT.md、WEBSOCKET_DEPLOYMENT.md、docker-compose.yml与 API 端点列表(/api/v1/chat、/file、/image、/voice、/deep_research)。
欢迎 Issue / PR,任何关于可用性、接口、模型适配与 WebSocket 细节的质疑与 Benchmark 都来。
如果觉得有用请给俺一个Star
这能给俺更大的动力
