注意：如果您在使用本项目时遇到问题，可以查看 FAQ 中的已知问题及解决方案。

目录

• 功能
• 路线图
• 开始使用
  • 更新代码
• 环境变量
  • 访问密码
  • 自定义模型列表
• 开发
  • 要求
• 部署
  • Docker（推荐）
  • 静态部署
• 常见问题
• 许可证
• 星标历史

功能

• 在 Vercel 上一键免费部署，不到 1 分钟即可完成
• 提供体积非常小（约 4MB）的跨平台客户端（Windows/MacOS/Linux），可常驻菜单栏以提升办公效率
• 支持多模态模型，能够理解图片、视频、音频及部分文本文档
• 对话模式：允许您直接与 Gemini 交流，支持多模态实时 API
• 视觉识别功能使 Gemini 能够理解图片内容
• 助手市场提供数百条精选系统指令
• 支持插件，内置网页搜索、网页阅读器、Arxiv 搜索、天气等实用插件
• 对话列表功能，方便您跟踪重要对话或与 Gemini 讨论不同话题
• 文档支持，让您更优雅地编辑对话内容
• 完全支持 Markdown：KaTex 公式、代码高亮、Mermaid 图表等
• 自动压缩上下文聊天记录以节省 Token，同时支持超长对话
• 注重隐私与安全，所有数据均保存在用户本地浏览器中
• 支持 PWA，可作为应用程序运行
• 界面设计精美，响应式布局，支持深色模式
• 首屏加载速度极快，支持流式响应
• 静态部署支持在任何支持静态页面的网站服务上部署，如 Github Page、Cloudflare、Vercel 等
• 多语言支持：英语、简体中文、繁体中文、日语、韩语、西班牙语、德语、法语、葡萄牙语、俄语和阿拉伯语

路线图

• 重构主题广场并引入提示词列表
• 使用 Tauri 打包桌面应用
• 基于 functionCall 插件实现功能
• 支持对话列表
• 支持对话导出功能
• 开启多模态实时 API
• 支持联网深度研究模式
• 支持本地知识库

开始使用

1. 获取 Gemini API 密钥

2. 一键部署项目，您可以选择部署到 Vercel

   

3. 开始使用

部署到 Cloudflare

目前该项目支持部署到 Cloudflare，但您需要按照 如何部署到 Cloudflare Pages 的说明进行操作。

更新代码

如果您想即时更新，可以查看 GitHub 文档 了解如何将分叉项目与上游代码同步。

您可以为该项目加星标或关注作者，以便及时获取发布通知。

环境变量

GEMINI_API_KEY（可选）

您的 Gemini API 密钥。如果需要 启用 服务器 API，则此变量为必填项。该变量不会影响前端页面上的 Gemini 密钥值。 支持多个密钥，各密钥之间用逗号分隔，例如 key1,key2,key3。

GEMINI_API_BASE_URL（可选）

默认值：https://generativelanguage.googleapis.com

示例：http://your-gemini-proxy.com

覆盖 Gemini API 请求的基础 URL。为避免服务器端代理 URL 泄露，前端页面中的值不会被覆盖或影响。

NEXT_PUBLIC_GEMINI_MODEL_LIST（可选）

自定义模型列表，默认为全部。

NEXT_PUBLIC_UPLOAD_LIMIT（可选）

文件上传大小限制。默认情况下无文件大小限制。

ACCESS_PASSWORD（可选）

访问密码。

HEAD_SCRIPTS（可选）

注入的脚本代码可用于统计或错误追踪。

EXPORT_BASE_PATH（可选）

仅用于在静态部署模式下设置页面基础路径。

访问密码

该项目提供有限的访问控制。请在 Vercel 的环境变量页面添加名为 ACCESS_PASSWORD 的环境变量。

添加或修改此环境变量后，请重新部署项目以使更改生效。

自定义模型列表

该项目支持自定义模型列表。请在 .env 文件或环境变量页面添加名为 NEXT_PUBLIC_GEMINI_MODEL_LIST 的环境变量。

默认模型列表表示为 all，多个模型之间用逗号分隔。 若需添加新模型，可直接写入 all,new-model-name，或使用 + 符号加上模型名称来添加，即 all,+new-model-name。 若要从模型列表中移除某个模型，可在模型名称前加 - 符号，例如 all,-existing-model-name。若要移除默认模型列表，可使用 -all。 若要设置默认模型，可使用 @ 符号加上模型名称来指定，默认模型，即 all,@default-model-name。

开发

如果您尚未安装 pnpm：

npm install -g pnpm

# 1. 首先安装 Node.js 和 Yarn
# 2. 配置本地变量，请将 `.env.example` 重命名为 `.env` 或 `.env.local`
# 3. 运行
pnpm install
pnpm dev

要求

NodeJS ≥ 18，Docker ≥ 20

部署

Docker（推荐）

Docker 版本需为 20 或以上，否则会提示无法找到镜像。

⚠️ 注意：通常情况下，Docker 版本会比最新版本落后 1 到 2 天，因此部署后可能会持续出现“存在更新”的提示，这是正常现象。

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

如需指定其他环境变量，请在上述命令中添加 -e key=value 来设置。

使用 docker-compose.yml 部署：

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

静态部署

你也可以直接构建一个静态页面版本，然后将 out 目录中的所有文件上传到任何支持静态页面的网站服务上，比如 Github Page、Cloudflare、Vercel 等。

pnpm build:export

如果你将项目部署在子目录中，并且访问时遇到资源加载失败的情况，请在 .env 文件或变量设置页面中添加 EXPORT_BASE_PATH=/path/project。

致谢

技术栈

• Next.js
• Shadcn UI
• Tailwindcss
• Zustand

灵感来源

• Lobe Chat
• Next Web
• Open Canvas

常见问题解答

“API 不支持用户所在地区”的解决方案

1. 使用 Cloudflare AI Gateway 转发 API。目前，Cloudflare AI Gateway 已经支持 Google Vertex AI 相关的 API。有关如何使用，请参阅 如何使用 Cloudflare AI Gateway。此方案速度快、稳定性高，推荐使用。

2. 使用 Cloudflare Worker 进行 API 代理转发。详细设置请参考 如何使用 Cloudflare Worker 代理 API。请注意，该方案在某些情况下可能无法正常工作。

为什么使用 Vercel 一键部署后在中国无法访问网站？

几年前，Vercel 部署后生成的域名曾被中国网络屏蔽，但服务器的 IP 地址并未被屏蔽。你可以自定义域名，在中国即可正常访问。由于 Vercel 在中国没有服务器，因此有时会出现网络波动的情况，这属于正常现象。关于如何设置域名，可以参考我在网上找到的解决方案文章 Vercel 绑定自定义域名。

为什么无法使用多模态直播功能？

目前，多模态直播 API 仅由 Gemini 2.0 Flash 模型支持，因此你需要使用 Gemini 2.0 Flash 模型才能使用该功能。由于 Gemini 多模态直播 API 在中国无法访问，你可能需要使用 Cloudflare Worker 部署一个代理转发 API。更多信息请参阅 使用 Cloudflare Worker 代理多模态直播 API。 目前，多模态直播 API 不支持中文语音输出。

参与贡献

欢迎为本项目做出贡献！如果你想参与贡献，请按照以下步骤操作：

1. 在 GitHub 上 fork 该项目。
2. 将你的 fork 克隆到本地。
3. 为你的更改创建一个新的分支。
4. 进行修改并提交到你的分支。
5. 将更改推送到你在 GitHub 上的 fork。
6. 从你的分支向主仓库发起 pull 请求。

请确保你的代码符合项目的编码规范，并在提交 pull 请求前运行所有测试以确保通过。如果你发现任何 bug 或有改进建议，欢迎在 GitHub 上提交 issue。

许可证

本项目采用 MIT 许可证授权。完整的许可证文本请参阅 LICENSE 文件。

星标历史

Gemini Next Chat 快速上手指南

Gemini Next Chat 是一个开源、高性能的 Gemini 聊天机器人框架，支持一键免费部署私有化 Web 应用。它支持 Gemini 1.5/2.0 多模态模型（图像、视频、音频识别）、语音对话模式、插件系统（联网搜索、天气等）以及跨平台桌面客户端。

环境准备

在开始之前，请确保满足以下前置条件：

• Gemini API Key：你需要一个 Google AI Studio 的 API Key。
  • 获取地址：https://aistudio.google.com/app/apikey
• 部署方式选择：
  • 方案 A（推荐新手）：拥有 GitHub 和 Vercel 账号，无需本地环境，可一键云端部署。
  • 方案 B（开发者）：本地安装了 Node.js (建议 v18+) 和 Git，用于本地开发或 Docker 部署。
• 网络环境：由于涉及 Google 服务，部署环境需具备访问 Google API 的能力（如配置代理或使用反向代理）。

安装与部署步骤

你可以选择以下任意一种方式进行部署：

方式一：一键部署到 Vercel（最简单）

适合希望快速拥有私有化网页版的用户。

1. 点击下方的 Deploy 按钮，跳转到 Vercel 导入页面：
2. 在 Vercel 设置页面中，配置以下环境变量：
   • GEMINI_API_KEY: 填入你的 Gemini API Key（支持多个，用逗号分隔）。
   • ACCESS_PASSWORD: （可选）设置访问密码，保护你的应用不被他人使用。
3. 点击 Deploy，等待构建完成即可获取访问域名。

方式二：Docker 部署（推荐自用/内网）

适合拥有服务器或希望本地运行的用户。

1. 拉取最新镜像：

   docker pull xiangfa/talk-with-gemini:latest
   

2. 运行容器（请替换 <YOUR_API_KEY> 和 <YOUR_PASSWORD>）：

   docker run -d -p 3000:3000 \
     -e GEMINI_API_KEY=<YOUR_API_KEY> \
     -e ACCESS_PASSWORD=<YOUR_PASSWORD> \
     --name gemini-next-chat \
     xiangfa/talk-with-gemini:latest
   

3. 访问 http://localhost:3000 即可使用。

方式三：本地源码运行（开发模式）

适合需要修改代码或贡献功能的开发者。

1. 克隆项目代码：

   git clone https://github.com/u14app/gemini-next-chat.git
   cd gemini-next-chat
   

2. 安装依赖：

   npm install
   # 或者使用国内镜像源加速
   # npm install --registry=https://registry.npmmirror.com
   

3. 配置环境变量： 在项目根目录创建 .env.local 文件，填入以下内容：

   GEMINI_API_KEY=你的 API_KEY
   ACCESS_PASSWORD=你的访问密码
   

4. 启动开发服务器：

   npm run dev
   

5. 浏览器访问 http://localhost:3000。

基本使用

部署完成后，即可通过浏览器或桌面客户端开始使用：

1. 网页访问：打开部署好的网址，如果设置了 ACCESS_PASSWORD，请输入密码进入。
2. 模型选择：在设置或对话框顶部，选择支持的模型（如 Gemini 1.5 Pro, Gemini 1.5 Flash 等）。
3. 多模态交互：
   • 图片识别：直接拖拽图片到对话框，或点击上传按钮，询问图片内容。
   • 语音对话：点击麦克风图标，开启 "Talk Mode"（需浏览器支持），可直接与 Gemini 进行语音交流。
4. 使用插件：
   • 在对话界面启用内置插件，如 Web Search（联网搜索）、Weather（天气查询）或 Arxiv Search（论文搜索），以获取实时信息。
5. 桌面客户端（可选）：
   • 前往 Releases 页面 下载对应系统（Windows/MacOS/Linux）的安装包。
   • 安装后可作为独立应用运行，支持常驻菜单栏，提升办公效率。

提示：所有对话数据默认保存在用户本地浏览器中，保障隐私安全。如需更换 API Key 或模型列表，可在设置页面或通过环境变量 NEXT_PUBLIC_GEMINI_MODEL_LIST 进行自定义。