Whirl 教程:452 星全栈 AI 聊天应用,源码即产品

📌 项目地址:github.com/whirlchat/whirl | 星数:452+ | 语言:TypeScript(Next.js + Convex)| 协议:MIT | 在线:whirl.chat

📋 项目简介

多数开源聊天应用是「能用的 demo」,Whirl 是「正在服务真实用户的源码」——whirl.chat 的完整后端与前端全部 MIT 公开。亮点是 living artifacts:AI 产出的文档、图表、交互页面常驻侧边栏持续编辑、链接分享;再配上 OpenRouter 全模型路由、MCP 工具、长期记忆与实时搜索,它是一个可以直接自部署的「ChatGPT 平替全家桶」。聊天客户端的移动端见 RikkaHub教程,模型路由见 Magpie教程。

✨ 功能清单

功能说明
全模型路由OpenRouter 接入每个顶级模型,思考等级可调
Living artifacts文档/图表/交互页面常驻侧边栏可编辑,链接分享
MCP 集成接入自己的工具(OAuth 齐全)+ 可安装 skills
长期记忆偏好与项目跨会话延续
实时搜索联网搜索 + 页面阅读,答案基于今天的网络
完全开源MIT,whirl.chat 的真实源码,可读可跑可改进

🚀 自部署

# 源码即产品(MIT)
git clone https://github.com/whirlchat/whirl.git
# 接入:
#   · Convex 后端
#   · OpenRouter key(全模型路由)
# 部署到 Vercel 等平台即可拥有自己的 whirl

# 或者直接用在线版 whirl.chat 体验

💡 使用建议

📚 常见问题

Whirl 是什么?

一个『在每个细节上较劲』的全栈 AI 聊天应用(whirlchat/whirl,452 星,MIT 开源):Next.js + Convex 构建,是 whirl.chat 的完整源码。每个顶级模型(经 OpenRouter 路由、可调思考等级)、living artifacts(可编辑可分享的文档/图表/整页)、MCP 工具集成(含 OAuth)、长期记忆、实时联网搜索。

living artifacts 是什么?

聊天产出的文档、图表和完整交互式页面不是一次性的文本块,而是常驻侧边栏、可持续编辑的『活文档』,还能通过链接分享给别人。这是 Whirl 与普通聊天应用最直观的差异——AI 的产出变成可维护的作品。

怎么自部署?

MIT 协议完整源码在 GitHub 公开:clone 后接 Convex 后端与 OpenRouter key 即可跑起自己的实例。功能清单:顶级模型路由、可安装的 skills 教 Whirl 新本领、MCP 工具(OAuth 齐全)、跨会话长期记忆、实时网页搜索与页面阅读。