中文文档 | English

一个功能丰富的 Google Gemini API 聊天客户端
支持多模型、图片生成、思维链展示等高级功能

功能特性 • 界面预览 • 快速开始 • Docker 部署 • 配置说明

• ✅ 支持自定义 API 端点（兼容第三方代理）
• ✅ 每个模型独立的参数配置
• ✅ 模型重定向 - 将自定义模型重定向到预设模型，自动继承目标模型的能力和参数配置

• 多窗口管理 - 创建多个独立的聊天窗口，每个窗口可配置不同的模型和参数
• 子话题对话 - 在同一窗口内创建多个子话题，方便组织不同的对话主题
• 消息编辑 - 支持编辑已发送的消息并重新生成回复
• 流式响应 - 实时显示 AI 回复，支持随时停止生成
• 思维链展示 - 支持显示模型的思考过程（Gemini 2.5/3 系列）
• Markdown 渲染 - 完整支持 Markdown 格式，包括代码高亮和 LaTeX 数学公式

• 图片上传 - 支持上传图片进行多模态对话
• 图片生成 - 使用 Imagen 模型生成图片（Gemini 3 Pro Image、2.5 Flash Image）
• 图片画廊 - 集中管理所有生成的图片
• 全屏预览 - 支持图片全屏查看和下载

• 💡 快捷参数调整 - 常用参数（思考程度、图片设置）可直接在聊天输入框上方快速修改，无需打开设置面板

• 密码保护 - 支持通过环境变量设置访问密码
• 本地存储 - 所有数据存储在浏览器本地（IndexedDB），不上传到服务器

• 深色/浅色主题切换
• 响应式设计，适配桌面和移动设备
• 可折叠侧边栏
• 调试面板（查看 API 请求详情、Token 使用量）

模型重定向功能允许你将自定义模型（如第三方代理的模型）重定向到预设模型，自动继承目标模型的能力配置（思考程度、图片生成等），无需重复配置。

• Node.js 18+
• npm / yarn / pnpm

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

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，设置 VITE_AUTH_PASSWORD=your_password

# 启动开发服务器
npm run dev

访问 http://localhost:5173 即可使用。

提示: 如果不设置 VITE_AUTH_PASSWORD，将使用默认密码 adminiadmin，首次登录后会提示修改。

直接从 GitHub Releases 下载最新版本的 Windows 安装包。

# 拉取镜像
docker pull bohesocool/gemini-chat:latest

# 运行容器
docker run -d \
  -p 5173:80 \
  -e VITE_AUTH_PASSWORD=your_password \
  --name gemini-chat \
  bohesocool/gemini-chat:latest

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

# 配置环境变量
cp .env.example .env
vim .env  # 修改 VITE_AUTH_PASSWORD

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

# 更新容器
git pull && docker-compose down && docker-compose up -d --build

部署完成后访问 http://localhost:5173 即可使用。

1. 打开应用后，点击侧边栏底部的 设置图标
2. 在「API 设置」中填入你的 Google AI API Key
3. API 端点留空将使用官方地址，也可填入第三方代理地址

1. 访问 Google AI Studio
2. 登录 Google 账号
3. 点击「Get API Key」获取密钥

欢迎提交 Issue 和 Pull Request！

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