Lobe Chat

LobeChat 是开源的高性能聊天机器人框架，支持语音合成、多模态、可扩展的（Function Call）插件系统。
支持一键免费部署私人 ChatGPT/LLM 网页应用程序。

English · 简体中文 · 更新日志 · 文档 · 报告问题 · 请求功能

分享 LobeChat 给你的好友

^{探索私人生产力的未来。在个体崛起的时代中为你打造.}

目录树

👋🏻 开始使用 & 交流

我们是一群充满热情的设计工程师，希望为 AIGC 提供现代化的设计组件和工具，并以开源的方式分享。不论普通用户与专业开发者 LobeHub 旨在成为所有人的 AI Agent 实验场，LobeChat 目前正在积极开发中，有需求或者问题，欢迎提交 issues

	无需安装或注册！访问我们的网站，快速体验
	加入我们的 Discord 社区！这是你可以与开发者和其他 LobeHub 热衷用户交流的地方

Important

收藏项目，你将从 GitHub 上无延迟地接收所有发布通知～⭐️

Star History

✨ 特性一览

`1` GPT 视觉认知

LobeChat 已经支持 OpenAI 最新的 gpt-4-vision 支持视觉识别的模型，这是一个具备视觉识别能力的多模态智能。用户可以轻松上传图片或者拖拽图片到对话框中，助手将能够识别图片内容，并在此基础上进行智能对话，构建更智能、更多元化的聊天场景。

这一特性打开了新的互动方式，使得交流不再局限于文字，而是可以涵盖丰富的视觉元素。无论是日常使用中的图片分享，还是在特定行业内的图像解读，助手都能提供出色的对话体验。

`2` TTS & STT 语音会话

LobeChat 支持文字转语音（Text-to-Speech，TTS）和语音转文字（Speech-to-Text，STT）技术，我们的应用能够将文本信息转化为清晰的语音输出，用户可以像与真人交谈一样与我们的对话代理进行交流。用户可以从多种声音中选择，给助手搭配合适的音源。同时，对于那些倾向于听觉学习或者想要在忙碌中获取信息的用户来说，TTS 提供了一个极佳的解决方案。

在 LobeChat 中，我们精心挑选了一系列高品质的声音选项 (OpenAI Audio, Microsoft Edge Speech)，以满足不同地域和文化背景用户的需求。用户可以根据个人喜好或者特定场景来选择合适的语音，从而获得个性化的交流体验。

Note

我们在实现该功能过程中，发现市面上并没有一款很好的 TTS 前端库。因此我们实现上耗费了很多精力，包括数据转换、音频进度管理、语音可视化等。于是我们决定把这套实现打磨并开源出来，希望能帮助到想要实现 TTS 的开发者们，@lobehub/tts 是一个使用 TS 语言开发的，高质量 TTS 工具包，支持在服务端和浏览器中使用。

服务端：只要使用 15 行代码，即可实现对标 OpenAI TTS 服务的高质量语音生成能力。目前支持 EdgeSpeechTTS 与 MicrosoftTTS 与 OpenAITTS、OpenAISTT。
浏览器：提供了高质量的 React Hooks 与可视化音频组件，支持加载、播放、暂停、拖动时间轴等常用功能，且提供了非常丰富的音轨样式调整能力。

`3` Text to Image 文生图

支持最新的文本到图片生成技术，LobeChat 现在能够让用户在与助手对话中直接调用文成图工具进行创作。通过利用 DALL-E 3、MidJourney 和 Pollinations 等 AI 工具的能力，助手们现在可以将你的想法转化为图像。同时可以更私密和沉浸式的完成你的创造过程。

`4` Function Calling 插件系统

LobeChat 的插件生态系统是其核心功能的重要扩展，它极大地增强了 ChatGPT 的实用性和灵活性。通过利用插件，ChatGPT 能够实现实时信息的获取和处理，例如自动获取最新新闻头条，为用户提供即时且相关的资讯。此外，这些插件不仅局限于新闻聚合，还可以扩展到其他实用的功能，如快速检索文档、获取电商平台数据、以及其他各式各样的第三方服务。

通过 Wiki 了解更多 📘 插件使用

Plugin-Demo.mp4

Tip

为了帮助开发者更好地参与到这个生态中来，我们在 🧩 插件体系部分提供了全面的开发资源。这包括详尽的组件开发文档、功能齐全的软件开发工具包（SDK），以及样板文件，这些都是为了简化开发过程，降低开发者的入门门槛。

Important

我们欢迎开发者利用这些资源，发挥创造力，编写出功能丰富、用户友好的插件。通过共同的努力，我们可以不断扩展聊天应用的功能界限，探索一个更加智能、高效的创造力平台。

最近新增	插件描述
图表和图示 ^{By pyxl on 2024-02-05}	美人鱼图表，演示文稿方案，分析，研究网站，饼图。 `图表` `图示`
社交搜索 ^{By say-apps on 2024-02-02}	社交搜索提供访问推文、用户、关注者、图片、媒体等功能。 `社交` `推特` `x` `搜索`
TokenInsights ^{By feednews on 2024-01-27}	获取实时加密货币价格，BTC，ETH，BNB 和最新见解。最新的币新闻和空投机会。 `加密货币` `btc` `eth` `bnb`
哔哩哔哩 ^{By LobeHub on 2024-01-27}	通过关键词视频搜索、回放访问、互动弹幕、热门视频推荐和热搜洞察等功能，深入体验哔哩哔哩丰富的内容，尽在您的指尖。 `视频` `哔哩哔哩` `搜索`

📊 Total plugins: 62

`5` 助手市场

在 LobeChat 的助手市场中，创作者们可以发现一个充满活力和创新的社区，它汇聚了众多精心设计的助手，这些助手不仅在工作场景中发挥着重要作用，也在学习过程中提供了极大的便利。我们的市场不仅是一个展示平台，更是一个协作的空间。在这里，每个人都可以贡献自己的智慧，分享个人开发的助手。

Tip

通过 🤖/🏪 提交助手，你可以轻松地将你的助手作品提交到我们的平台。我们特别强调的是，LobeChat 建立了一套精密的自动化国际化（i18n）工作流程，它的强大之处在于能够无缝地将你的助手转化为多种语言版本。这意味着，不论你的用户使用何种语言，他们都能无障碍地体验到你的助手。

Important

我欢迎所有用户加入这个不断成长的生态系统，共同参与到助手的迭代与优化中来。共同创造出更多有趣、实用且具有创新性的助手，进一步丰富助手的多样性和实用性。

最近新增	助手说明
数据库专家 ^{By xuzhen1994 on 2024-02-03}	角色：数据库专家
专长：具备数据库方面的专业知识。关系型数据库，比如 MySQL、PostgreSQL、Oracle 等的工作原理、优缺点、适用场景以及最佳实践。非关系型数据库，比如 MongoDB、Cassandra、Redis 等的特点和使用场景。列式数据库，例如 ClickHouse、Vertica 等的优势和适用情况。分布式数据库系统，例如 Doris、HBase、CockroachDB 等的原理和应用等。
职责：提供关于数据库设计范式、索引优化、查询性能调优、数据安全、备份与恢复等方面的专业建议。另外还有对于数据库集群部署、容灾设计、数据迁移等高级主题的指导。 `数据库` `dba` `mysql` `clickhouse` `doris` `mongo-db` `oracle`
演示向导 ^{By MYSeaIT on 2024-02-03}	Word 应用演示制作机器人：帮助在 Microsoft Word 中创建令人印象深刻和专业的应用程序演示。 `应用程序演示` `微软-word` `机器人` `辅助` `模板`
SagePathfinder ^{By Ajasra on 2024-01-31}	专注于斯多葛主义、深度反思和战略性提问的个人成长教练专家。 `个人成长` `教练` `反思` `目标设定` `幸福感`
变量命名大师 ^{By undefinedZNN on 2024-01-31}	精通编程变量命名，提供多个建议并解释使用场景。 `变量命名` `编程` `建议`

📊 Total agents: 149

`6` PWA 渐进式 Web 应用

我们利深知在当今多设备环境下为用户提供无缝体验的重要性。为此，我们采用了渐进式 Web 应用 PWA 技术，这是一种能够将网页应用提升至接近原生应用体验的现代 Web 技术。通过 PWA，LobeChat 能够在桌面和移动设备上提供高度优化的用户体验，同时保持轻量级和高性能的特点。在视觉和感觉上，我们也经过精心设计，以确保它的界面与原生应用无差别，提供流畅的动画、响应式布局和适配不同设备的屏幕分辨率。

Note

若您未熟悉 PWA 的安装过程，您可以按照以下步骤将 LobeChat 添加为您的桌面应用（也适用于移动设备）：

在电脑上运行 Chrome 或 Edge 浏览器 .
访问 LobeChat 网页 .
在地址栏的右上角，单击 安装 图标 .
根据屏幕上的指示完成 PWA 的安装 .

`7` 移动设备适配

针对移动设备进行了一系列的优化设计，以提升用户的移动体验。目前，我们正在对移动端的用户体验进行版本迭代，以实现更加流畅和直观的交互。如果您有任何建议或想法，我们非常欢迎您通过 GitHub Issues 或者 Pull Requests 提供反馈。

`8` 自定义主题

作为设计工程师出身 LobeChat 在界面设计上十分考虑用户的个性化体验，因此引入了灵活多变的主题模式，其中包括日间的亮色模式和夜间的深色模式。除了主题模式的切换，提供了一系列的颜色定制选项，允许用户根据自己的喜好来调整应用的主题色彩。无论是想要沉稳的深蓝，还是希望活泼的桃粉，或者是专业的灰白，用户都能够在 LobeChat 中找到匹配自己风格的颜色选择。

Tip

默认配置能够智能地识别用户系统的颜色模式，自动进行主题切换，以确保应用界面与操作系统保持一致的视觉体验。对于喜欢手动调控细节的用户，LobeChat 同样提供了直观的设置选项，针对聊天场景也提供了对话气泡模式和文档模式的选择。

⚡️ 性能测试

Note

完整测试报告可见 📘 Lighthouse 性能测试

Desktop	Mobile

📑 Lighthouse 测试报告	📑 Lighthouse 测试报告

🛳 开箱即用

LobeChat 提供了 Vercel 的自托管版本和 Docker 镜像，这使你可以在几分钟内构建自己的聊天机器人，无需任何基础知识。

`A` 使用 Vercel、Zeabur 或 Sealos 部署

如果想在 Vercel 或 Zeabur 上部署该服务，可以按照以下步骤进行操作：

准备好你的 OpenAI API Key 。
点击下方按钮开始部署：直接使用 GitHub 账号登录即可，记得在环境变量页填入 OPENAI_API_KEY （必填） and ACCESS_CODE（推荐）；
部署完毕后，即可开始使用；
绑定自定义域名（可选）：Vercel 分配的域名 DNS 在某些区域被污染了，绑定自定义域名即可直连。目前 Zeabur 提供的域名还未被污染，大多数地区都可以直连。

使用 Vercel 部署	使用 Zeabur 部署	使用 Sealos 部署

保持更新

如果你根据 README 中的一键部署步骤部署了自己的项目，你可能会发现总是被提示 “有可用更新”。这是因为 Vercel 默认为你创建新项目而非 fork 本项目，这将导致无法准确检测更新。

Tip

我们建议按照 📘 LobeChat 自部署保持更新步骤重新部署。

`B` 使用 Docker 部署

我们提供了 Docker 镜像，供你在自己的私有设备上部署 LobeChat 服务。使用以下命令即可使用一键启动 LobeChat 服务：

$ docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=sk-xxxx \
  -e ACCESS_CODE=lobe66 \
  --name lobe-chat \
  lobehub/lobe-chat

Tip

如果你需要通过代理使用 OpenAI 服务，你可以使用 OPENAI_PROXY_URL 环境变量来配置代理地址：

$ docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=sk-xxxx \
  -e OPENAI_PROXY_URL=https://api-proxy.com/v1 \
  -e ACCESS_CODE=lobe66 \
  --name lobe-chat \
  lobehub/lobe-chat

Note

有关 Docker 部署的详细说明，详见 📘 使用 Docker 部署

环境变量

本项目提供了一些额外的配置项，使用环境变量进行设置：

环境变量	类型	描述	示例
`OPENAI_API_KEY`	必选	这是你在 OpenAI 账户页面申请的 API 密钥	`sk-xxxxxx...xxxxxx`
`OPENAI_PROXY_URL`	可选	如果你手动配置了 OpenAI 接口代理，可以使用此配置项来覆盖默认的 OpenAI API 请求基础 URL	`https://api.chatanywhere.cn` 或 `https://aihubmix.com/v1` 默认值: `https://api.openai.com/v1`
`ACCESS_CODE`	可选	添加访问此服务的密码，你可以设置一个长密码以防被爆破，该值用逗号分隔时为密码数组	`awCTe)re_r74` or `rtrt_ewee3@09!` or `code1,code2,code3`
`CUSTOM_MODELS`	可选	用来控制模型列表，使用 `+` 增加一个模型，使用 `-` 来隐藏一个模型，使用 `模型名=展示名` 来自定义模型的展示名，用英文逗号隔开。	`qwen-7b-chat,+glm-6b,-gpt-3.5-turbo`

Note

完整环境变量可见 📘环境变量

获取 OpenAI API Key

API Key 是使用 LobeChat 进行大语言模型会话的必要信息，本节以 OpenAI 模型服务商为例，简要介绍获取 API Key 的方式。

`A` 通过 OpenAI 官方渠道

注册一个 OpenAI 账户，你需要使用国际手机号、非大陆邮箱进行注册；
注册完毕后，前往 API Keys 页面，点击 Create new secret key 创建新的 API Key:

步骤 1：打开创建窗口	步骤 2：创建 API Key	步骤 3：获取 API Key

将此 API Key 填写到 LobeChat 的 API Key 配置中，即可开始使用。

Tip

账户注册后，一般有 5 美元的免费额度，但有效期只有三个月。如果你希望长期使用你的 API Key，你需要完成支付的信用卡绑定。由于 OpenAI 只支持外币信用卡，因此你需要找到合适的支付渠道，此处不再详细展开。

`B` 通过 OpenAI 第三方代理商

如果你发现注册 OpenAI 账户或者绑定外币信用卡比较麻烦，可以考虑借助一些知名的 OpenAI 第三方代理商来获取 API Key，这可以有效降低获取 OpenAI API Key 的门槛。但与此同时，一旦使用三方服务，你可能也需要承担潜在的风险，请根据你自己的实际情况自行决策。以下是常见的第三方模型代理商列表，供你参考：

	服务商	特性说明	Proxy 代理地址	链接
	AiHubMix	使用 OpenAI 企业接口，全站模型价格为官方一半（含 GPT-4 ）	`https://aihubmix.com/v1`	获取

Warning

免责申明: 在此推荐的 OpenAI API Key 由第三方代理商提供，所以我们不对 API Key 的 有效性 和 安全性 负责，请你自行承担购买和使用 API Key 的风险。

Note

如果你是模型服务商，并认为自己的服务足够稳定且价格实惠，欢迎联系我们，我们会在自行体验和测试后酌情推荐。

📦 生态系统

NPM	仓库	描述
@lobehub/ui	lobehub/lobe-ui	Lobe UI 是一个专为构建 AIGC 网页应用程序而设计的开源 UI 组件库。
@lobehub/tts	lobehub/lobe-tts	Lobe TTS 是一个专为 TTS/STT 建设的语音合成 / 识别 React Hooks 库
@lobehub/lint	lobehub/lobe-lint	LobeLint 为 LobeHub 提供 ESlint，Stylelint，Commitlint，Prettier，Remark 和 Semantic Release 的配置。
@lobehub/assets	lobehub/assets	LobeHub 的 Logo 资源、favicon、网页字体。

🧩 插件体系

插件提供了扩展 LobeChat Function Calling 能力的方法。可以用于引入新的 Function Calling，甚至是新的消息结果渲染方式。如果你对插件开发感兴趣，请在 Wiki 中查阅我们的 📘 插件开发指引。

lobe-chat-plugins：这是 LobeChat 的插件索引。它从该仓库的 index.json 中获取插件列表并显示给用户。
chat-plugin-template: Chat Plugin 插件开发模版，你可以通过项目模版快速新建插件项目。
@lobehub/chat-plugin-sdk：LobeChat 插件 SDK 可帮助您创建出色的 Lobe Chat 插件。
@lobehub/chat-plugins-gateway：LobeChat 插件网关是一个后端服务，作为 LobeChat 插件的网关。我们使用 Vercel 部署此服务。主要的 API POST /api/v1/runner 被部署为 Edge Function。

Note

插件系统目前正在进行重大开发。您可以在以下 Issues 中了解更多信息:

插件一期: 实现插件与主体分离，将插件拆分为独立仓库维护，并实现插件的动态加载
插件二期: 插件的安全性与使用的稳定性，更加精准地呈现异常状态，插件架构的可维护性与开发者友好
插件三期：更高阶与完善的自定义能力，支持插件鉴权与示例

⌨️ 本地开发

可以使用 GitHub Codespaces 进行在线开发：

或者使用以下命令进行本地开发：

$ git clone https://github.com/lobehub/lobe-chat.git
$ cd lobe-chat
$ pnpm install
$ pnpm run dev

如果你希望了解更多详情，欢迎可以查阅我们的 📘 开发指南

🤝 参与贡献

我们非常欢迎各种形式的贡献。如果你对贡献代码感兴趣，可以查看我们的 GitHub Issues 和 Projects，大展身手，向我们展示你的奇思妙想。

Tip

我们希望创建一个技术分享型社区，一个可以促进知识共享、想法交流，激发彼此鼓励和协作的环境。同时欢迎联系我们提供产品功能和使用体验反馈，帮助我们将 LobeChat 建设得更好。

组织维护者: @arvinxx @canisminor1990

🩷 感谢赞助

每一分支持都珍贵无比，汇聚成我们支持的璀璨银河！你就像一颗划破夜空的流星，瞬间点亮我们前行的道路。感谢你对我们的信任 —— 你的支持笔就像星辰导航，一次又一次地为项目指明前进的光芒。

🔗 更多工具

🤯 Lobe Theme : Stable Diffusion WebUI 的现代主题，精致的界面设计，高度可定制的 UI，以及提高效率的功能。
🌏 Lobe i18n : Lobe i18n 是一个由 ChatGPT 驱动的 i18n（国际化）翻译过程的自动化工具。它支持自动分割大文件、增量更新，以及为 OpenAI 模型、API 代理和温度提供定制选项的功能。
💌 Lobe Commit : Lobe Commit 是一个 CLI 工具，它利用 Langchain/ChatGPT 生成基于 Gitmoji 的提交消息。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.zh-CN.md

README.zh-CN.md

Lobe Chat

TOC

👋🏻 开始使用 & 交流

✨ 特性一览

`1` GPT 视觉认知

`2` TTS & STT 语音会话

`3` Text to Image 文生图

`4` Function Calling 插件系统

`5` 助手市场

`6` PWA 渐进式 Web 应用

`7` 移动设备适配

`8` 自定义主题

更多特性

⚡️ 性能测试

🛳 开箱即用

`A` 使用 Vercel、Zeabur 或 Sealos 部署

保持更新

`B` 使用 Docker 部署

环境变量

获取 OpenAI API Key

`A` 通过 OpenAI 官方渠道

`B` 通过 OpenAI 第三方代理商

📦 生态系统

🧩 插件体系

⌨️ 本地开发

🤝 参与贡献

🩷 感谢赞助

🔗 更多工具

📝 License

Files

README.zh-CN.md

Latest commit

History

README.zh-CN.md

File metadata and controls

Lobe Chat

TOC

👋🏻 开始使用 & 交流

✨ 特性一览

1 GPT 视觉认知

2 TTS & STT 语音会话

3 Text to Image 文生图

4 Function Calling 插件系统

5 助手市场

6 PWA 渐进式 Web 应用

7 移动设备适配

8 自定义主题

更多特性

⚡️ 性能测试

🛳 开箱即用

A 使用 Vercel、Zeabur 或 Sealos 部署

保持更新

B 使用 Docker 部署

环境变量

获取 OpenAI API Key

A 通过 OpenAI 官方渠道

B 通过 OpenAI 第三方代理商

📦 生态系统

🧩 插件体系

⌨️ 本地开发

🤝 参与贡献

🩷 感谢赞助

🔗 更多工具

📝 License

`1` GPT 视觉认知

`2` TTS & STT 语音会话

`3` Text to Image 文生图

`4` Function Calling 插件系统

`5` 助手市场

`6` PWA 渐进式 Web 应用

`7` 移动设备适配

`8` 自定义主题

`A` 使用 Vercel、Zeabur 或 Sealos 部署

`B` 使用 Docker 部署

`A` 通过 OpenAI 官方渠道

`B` 通过 OpenAI 第三方代理商