chat-js

快速搭起生产级 AI 聊天应用,多模型随意切换

chat-js 是一个生产就绪的 AI 聊天应用模板,基于 TypeScript 和 Next.js 构建,前身是 Sparka AI。它解决了开发者从零搭建 AI 聊天界面的重复劳动问题,提供开箱即用的聊天 UI、流式响应、多模型支持等核心能力。项目集成了 OpenAI、Anthropic、Gemini、Grok 等主流 LLM 提供商,通过统一的接口切换模型,并支持自定义后端逻辑。其设计理念是“从这里开始,然后变成你自己的”,即提供完整的聊天应用骨架,开发者可在此基础上快速定制品牌、功能和业务逻辑。代码结构清晰,文档完善,适合作为生产级 AI 应用的基础。

开源 unknown 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 1199
维护状态 活跃
是否开源 是
定价模式 unknown

项目数据

分类对话助手
开发团队FranciscoMoretti
所属国家
官网地址https://chatjs.dev
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型ai,anthropic,chat,chatbot,chatgpt,claude,gemini,gemini-ai,grok,llm,multiprovider,openai,xai
GitHub 星标★ 1199
30天Star增速
HF 下载量
上线时间2025-03-22 00:00:00
最近更新2026-09-16 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数4

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 4 步

环境要求

  • 本地已安装 Node.js 与 npm(能使用 npx 命令)
  • 网络可访问 npm registry 以下载 @chat-js/cli
  • 一个可用于模型调用的 AI Gateway API Key(CLI 会列出所需环境变量)
  • 如需 OAuth 登录,需准备 GitHub / Google 的应用凭据(可选)

安装与启动步骤

  1. 1确认 Node 环境

    ChatJS 采用 Next.js + TypeScript,CLI 通过 npx 分发,因此本机需先装好 Node.js 与 npm,并确保 npx 可执行。

    node -v
    npm -v
  2. 2创建 ChatJS 应用

    运行官方 CLI 脚手架命令,末尾的 my-app 是项目目录名,可按需改成自己的名字。

    npx @chat-js/cli@latest create my-app
  3. 3按向导选择方案

    CLI 会依次询问网关(gateway)、功能特性(features)与认证方式(auth),按业务需要选择即可。

  4. 4确认生成产物

    向导结束后会生成 chat.config.ts,并列出你所选配置对应的环境变量清单,照着清单去填 .env。

关键配置

配置项必填说明示例
chat.config.ts是CLI 根据你的选择自动生成的聊天应用主配置文件由 npx @chat-js/cli create 自动生成

如何确认成功

CLI 向导正常跑完,项目目录下出现 chat.config.ts,且终端打印出所需环境变量清单,即表示脚手架创建成功。

常见问题

Q:运行前需要准备什么环境?

A:需要本机已安装 Node.js 与 npm,因为官方安装方式是通过 npx 执行 @chat-js/cli 脚手架命令。

Q:支持哪些大模型?

A:README 说明支持 120+ 模型,包括 Claude、GPT、Gemini、Grok,通过统一的 AI Gateway 接口调用。

Q:登录方式有哪些?

A:内置 GitHub、Google 和匿名登录三种方式,创建项目时在 CLI 向导里选择即可。

Q:怎么查看完整文档?

A:官方文档地址为 https://chatjs.dev/docs,官网为 https://chatjs.dev,另有在线演示 demo.chatjs.dev。

注意事项

  • README 节选只给出了 npx 创建命令,未提供启动/构建命令,请到 chatjs.dev/docs 查看后再运行
  • 向导会询问 gateway、features、auth 选项,建议先想清楚所需功能再执行
  • CLI 列出的环境变量需填入项目环境文件,切勿把密钥提交到 Git 仓库
  • 项目支持用 Electron 打包为 macOS、Windows、Linux 桌面应用

核心亮点

  • 内置多模型提供商适配(OpenAI/Anthropic/Gemini/Grok),切换模型只需改配置
  • 开箱即用的完整聊天 UI 和流式响应,省去前端开发时间
  • 基于 Next.js 和 TypeScript,代码结构清晰,易于二次开发和部署

不足之处

  • 文档/社区待观察

适用场景

  • 快速搭建面向用户的 AI 聊天产品原型
  • 企业内部 AI 助手或客服聊天界面开发
  • 学习多模型集成和流式聊天实现参考

替代项目

Vercel AI Chat、Chatbot UI、Open WebUI

项目介绍

chat-js 是对话助手领域的开源项目,由 FranciscoMoretti 开发,2025 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(1,199)位列前 30%,在对话助手分类中处于中上游。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-16。从国内网络环境看,可直接访问。

它主要面向的使用场景是:快速搭建面向用户的AI聊天产品原型。同类可对比的替代方案包括 Vercel AI Chat、Chatbot UI、Open WebUI。

上一篇:Awesome-AI-GPTs

下一篇:hollama

同类项目推荐

open-webui 开源

给本地模型配个漂亮聊天室,全家都能用

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

★ 152821 2026-08-09
prompts.chat 开源

海量好提示词,抄了就能让 AI 更听话

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the commun···

★ 170999 2026-08-09
elia 开源

终端里用键盘快速聊 AI,多模型切换不打断思路

A snappy, keyboard-centric terminal user interface for interacting with large langua···

★ 2479 2026-08-09
NextChat 开源

一个界面聊遍所有主流AI模型,支持全平台部署,轻快又私密。

✨ Zero-config AI chat assistant. No API key needed — sign up and instantly chat wi···

★ 88802 2026-08-09