Gemini Next Chat - 开源 Gemini AI 聊天应用框架

Gemini Next Chat 是一个开源的 Gemini AI 聊天应用框架，支持一键免费部署私有 Gemini 应用。该项目基于 Next.js 构建，提供了丰富的功能和良好的用户体验，目前已获得 1.6k+ stars。

项目简介

Gemini Next Chat 让你能够快速部署属于自己的 Gemini AI 聊天应用，支持 Gemini 1.5 Pro、Gemini 1.5 Flash、Gemini Pro 和 Gemini Pro Vision 等多个模型。项目采用 MIT 许可证开源，代码托管在 GitHub 上。

项目亮点：

• 支持一键免费部署到 Vercel
• 提供跨平台桌面客户端（Windows/MacOS/Linux）
• 支持多模态模型，可理解图片、视频、音频和文档
• 内置多种实用插件
• 支持 Multimodal Live API 实时语音对话

核心特性

部署与使用

• 一键免费部署：可在 Vercel 上 1 分钟内完成部署
• 跨平台客户端：提供约 4MB 的轻量级桌面应用，支持常驻菜单栏
• PWA 支持：可作为应用安装运行
• 静态部署：支持部署到任何支持静态页面的服务

AI 功能

• 多模态支持：理解图片、视频、音频和文本文档
• 对话模式：直接与 Gemini 语音对话，支持 Multimodal Live API
• 视觉识别：让 Gemini 理解图片内容
• 助手市场：数百个精选系统指令

插件系统

内置多种实用插件：

• Web 搜索
• Web 阅读器
• Arxiv 搜索
• 天气查询

用户体验

• 对话列表：管理和追踪重要对话
• Artifact 支持：优雅地修改对话内容
• 完整 Markdown 支持：KaTex 公式、代码高亮、Mermaid 图表
• 上下文压缩：自动压缩聊天记录，节省 Token 同时支持超长对话
• 隐私安全：所有数据保存在用户浏览器本地
• 多语言支持：英语、简体中文、繁体中文、日本語、한국어、Español、Deutsch、Français、Português、Русский、العربية

技术栈

快速开始

前置要求

• Node.js >= 18
• Docker >= 20（可选）

安装步骤

1. 获取 Gemini API Key 访问 Google AI Studio 获取 API Key

2. 一键部署到 Vercel

3. 本地开发

# 安装 pnpm（如未安装）
npm install -g pnpm

# 克隆项目
git clone https://github.com/u14app/gemini-next-chat.git
cd gemini-next-chat

# 配置环境变量
cp .env.example .env.local

# 安装依赖并启动
pnpm install
pnpm dev

Docker 部署（推荐）

# 拉取镜像
docker pull xiangfa/talk-with-gemini:latest

# 运行容器
docker run -d --name talk-with-gemini -p 5481:3000 xiangfa/talk-with-gemini

# 带环境变量运行
docker run -d --name talk-with-gemini \
  -p 5481:3000 \
  -e GEMINI_API_KEY=AIzaSy... \
  -e ACCESS_PASSWORD=your-password \
  xiangfa/talk-with-gemini

Docker Compose 部署

version: '3.9'
services:
  talk-with-gemini:
    image: xiangfa/talk-with-gemini
    container_name: talk-with-gemini
    environment:
      - GEMINI_API_KEY=AIzaSy...
      - ACCESS_PASSWORD=your-password
    ports:
      - 5481:3000

环境变量配置

自定义模型列表

使用 NEXT_PUBLIC_GEMINI_MODEL_LIST 环境变量自定义模型列表：

• all - 使用默认模型列表
• all,new-model - 添加新模型
• all,+new-model - 使用 + 添加模型
• all,-model-name - 使用 - 移除模型
• -all - 移除默认列表
• all,@default-model - 使用 @ 设置默认模型

部署到 Cloudflare

项目支持部署到 Cloudflare Pages，详细步骤请参考 How to deploy to Cloudflare Page。

常见问题

"User location is not supported for the API use"

解决方案 1（推荐）：使用 Cloudflare AI Gateway 转发 API，支持 Google Vertex AI 相关 API。参考 How to Use Cloudflare AI Gateway。

解决方案 2：使用 Cloudflare Worker 代理 API。参考 How to Use Cloudflare Worker Proxy API。

国内无法访问 Vercel 部署的网站

Vercel 生成的域名被国内网络屏蔽，但服务器 IP 未被屏蔽。可以绑定自定义域名后正常访问。

Multimodal Live 无法使用

目前 Multimodal Live API 仅 Gemini 2.0 Flash 模型支持。由于该 API 在国内无法访问，可能需要使用 Cloudflare Worker 部署代理。参考 Proxying the Multimodal Live API with Cloudflare Worker。

注意：目前 Multimodal Live API 不支持中文语音输出。

未来规划

• 重构话题广场，引入 Prompt 列表
• 使用 Tauri 打包桌面应用
• 基于 functionCall 实现插件系统
• 支持对话列表
• 支持对话导出功能
• 启用 Multimodal Live API
• 支持联网 Deep Research 模式
• 支持本地知识库

项目链接

• GitHub 仓库：https://github.com/u14app/gemini-next-chat
• 在线演示：https://gemini.u14.app/
• 桌面客户端：Releases 页面

许可证

本项目采用 MIT 许可证开源。