@lobehub/chat

Lobe Chat

LobeChat is an open-source, extensible (Function Calling) high-performance chatbot framework.
It supports one-click free deployment of your private ChatGPT/LLM web application.

English · 简体中文 · Changelog · Wiki · Report Bug · Request Feature

Share LobeChat Repository

^{Pioneering the new age of thinking and creating. Built for you, the Super Individual.}

Table of contents

TOC

• 👋🏻 Getting Started & Join Our Community
• ✨ Features
• 📸 Snapshot
• ⚡️ Performance
• 🛳 Self Hosting
  • A Deploying with Vercel
  • B Deploying with Docker
  • Environment Variable
• 📦 Ecosystem
• 🧩 Plugins
• ⌨️ Local Development
• 🤝 Contributing
• 🔗 More Products

👋🏻 Getting Started & Join Our Community

Please be aware that LobeChat is currently under active development, and feedback is welcome for any issues encountered.

	No installation or registration necessary! Visit our website to experience it firsthand.
	Join our Discord community! This is where you can connect with developers and other enthusiastic users of LobeHub.

[!IMPORTANT]

Star Us, You will receive all release notifications from GitHub without any delay ~ ⭐️

Star History

✨ Features

• 💎 Exquisite UI Design: With a carefully designed interface, it offers an elegant appearance and smooth interaction. It supports light and dark themes and is mobile-friendly. PWA support provides a more native-like experience.
• 🗣️ Smooth Conversation Experience: Fluid responses ensure a smooth conversation experience. It fully supports Markdown rendering, including code highlighting, LaTex formulas, Mermaid flowcharts, and more.
• 🤖 Customizable Agent Roles: Users can create, share, and debug personalized dialogue agent roles according to their needs, providing more flexible and customized dialogue functions.
• 🧩 Plugin Support & Custom Plugin Development: Conversations are extendable with plugins. Users can install and use various plugins, such as search engines, web extraction, etc. It also supports the development of custom plugins to meet custom needs.
• 🏬 Agent Market: A Agent Market is provided where users can select their preferred dialogue agent roles, enriching the content and style of the dialogue.
• 👁️ Visual Recognition: With the integration of visual recognition capabilities, your agent can now analyze and understand images provided during the conversation. This allows for more interactive and context-aware conversations, enabling the dialogue agent to provide relevant and accurate responses based on visual content.
• （WIP）📢 Text-to-Speech (TTS) Conversation: LobeChat are supporting Text-to-Speech technology, allowing users to have voice-based conversations with the dialogue agent. This feature enhances the user experience by providing a more natural and immersive conversation environment. Users can choose from a variety of voices and adjust the speech rate to suit their preferences.

[!NOTE]

You can find our upcoming Roadmap plans in the Projects section.

---

Beside these features, LobeChat also have much better basic technique underground:

• 💨 Quick Deployment: Using the Vercel platform or docker image, you can deploy with just one click and complete the process within 1 minute without any complex configuration.
• 🌐 Custom Domain: If users have their own domain, they can bind it to the platform for quick access to the dialogue agent from anywhere.
• 🔒 Privacy Protection: All data is stored locally in the user's browser, ensuring user privacy.

📸 Snapshot

1 Function Calling Plugin System

By establishing a versatile plugin system, ChatGPT becomes capable of delivering real-time news updates and enhancing your ability to interact with documents and e-commerce data more effectively. This extended functionality positions ChatGPT as a valuable resource across diverse domains. If you have an interest in creating plugins, we offer comprehensive component development documentation, software development kits (SDKs), and pre-made templates in the 🧩 Plugin System section below. Join us in our collective efforts to empower ChatGPT, making it both more potent and user-friendly.

https://github.com/lobehub/lobe-chat/assets/28616219/f29475a3-f346-4196-a435-41a6373ab9e2

2 Prompt Agent Market

In our agent market. We have accumulated a large number of practical, prompt agents that have been used in daily work and study. You can also share your agents here and iterate and optimize your prompt agents with more people. You can submit your agents through 🤖/🏪 Submit Agents, and our automated i18n workflow will automatically translate your agents into multiple languages, allowing users worldwide to enjoy your wisdom.

Recent Submits	Description
Short Video Script Assistant By aihoom on 2023-11-17	Designed to help users write engaging and trendy short video scripts short-video tkitok screenwriter
Expert Agent Mentor By tcmonster on 2023-11-16	Call on expert agents perfectly suited for the task to support your goals task-guidance execution-plan communication support
Full-stack Developer By cloverfield11 on 2023-11-15	Full-stack web developer with experience in HTML, CSS, JavaScript, Python, Java, Ruby, and frameworks such as React, Angular, Vue.js, Express, Django, Next.js, Flask, or Ruby on Rails. Experience in databases, application architecture, security, and testing. web-development front-end back-end programming databases
Graphic Creative Master By yingxirz on 2023-11-15	Specializes in graphic creative design and graphic creativity graphic creative design graphic-design

📊 Total agents: 48

3 Progress Web App

Utilize the Progressive Web Application (PWA) technology to achieve a seamless LobeChat experience on your computer or mobile device.

[!NOTE]

If you are unfamiliar with the installation process of PWA, you can add LobeChat as your desktop application (also applicable to mobile devices) by following these steps:

• Launch the Chrome or Edge browser on your computer.
• Visit the LobeChat webpage.
• In the upper right corner of the address bar, click on the Install icon.
• Follow the instructions on the screen to complete the PWA Installation.

4 Theme Mode Selection

LobeChat offers two unique theme modes - Light Mode and Dark Mode, as well as rich color customization options to meet your personalized needs. By default, our themes will intelligently switch based on your system settings, but if you prefer manual control, you can easily switch in the settings.

5 Mobile Device Adaptation

We have carried out a series of optimization designs for mobile devices to enhance the user's mobile experience. Currently, we are iterating on the mobile user experience to achieve smoother and more intuitive interactions. If you have any suggestions or ideas, we welcome you to provide feedback through GitHub Issues or Pull Requests.

6 Visual Model Support

We have support gpt-4-vision model.You can just upload, drag/drop or just paste your image to chat.

🚧 Additional snapshots and demonstrations are being progressively added...

⚡️ Performance

[!NOTE]

The complete list of reports can be found in the 📘 Lighthouse Reports

Desktop	Mobile
📑 Lighthouse Report	📑 Lighthouse Report

🛳 Self Hosting

LobeChat provides Self-Hosted Version with Vercel and Docker Image. This allows you to deploy your own chatbot within a few minutes without any prior knowledge.

A Deploying with Vercel

If you want to deploy this service yourself on Vercel, you can follow these steps:

• Prepare your OpenAI API Key.
• Click the button below to start deployment: Deploy with Vercel. Log in directly with your GitHub account, and remember to fill in the OPENAI_API_KEY(required) and ACCESS_CODE (recommended) on the environment variable section.
• After deployment, you can start using it.
• Bind a custom domain (optional): The DNS of the domain assigned by Vercel is polluted in some areas; binding a custom domain can connect directly.

Keep Updated

If you have deployed your own project following the one-click deployment steps in the README, you might encounter constant prompts indicating "updates available." This is because Vercel defaults to creating a new project instead of forking this one, resulting in an inability to detect updates accurately.

[!TIP]

We suggest you redeploy using the following steps, 📘 Maintaining Updates with LobeChat Self-Deployment.

B Deploying with Docker

We provide a Docker image for deploying the LobeChat service on your own private device. Use the following command to start the LobeChat service:

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

[!TIP]

If you need to use the OpenAI service through a proxy, you can configure the proxy address using the OPENAI_PROXY_URL environment variable:

$ 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 \
  lobehub/lobe-chat

[!NOTE]

For detailed instructions on deploying with Docker, please refer to the 📘 Docker Deployment Guide

Environment Variable

This project provides some additional configuration items set with environment variables:

Environment Variable	Required	Description	Example
OPENAI_API_KEY	Yes	This is the API key you apply on the OpenAI account page	sk-xxxxxx...xxxxxx
OPENAI_PROXY_URL	No	If you manually configure the OpenAI interface proxy, you can use this configuration item to override the default OpenAI API request base URL	https://api.chatanywhere.cn/v1 The default value is https://api.openai.com/v1
ACCESS_CODE	No	Add a password to access this service; the password should be a 6-digit number or letter	awCT74 or e3@09!

[!NOTE]

The complete list of environment variables can be found in the 📘 Environment Variables

📦 Ecosystem

NPM	Repository	Description	Version
@lobehub/ui	lobehub/lobe-ui	Lobe UI is an open-source UI component library dedicated to building AIGC web applications.
@lobehub/tts	lobehub/lobe-tts	Lobe TTS is a high-quality & reliable TTS/STT React Hooks library
@lobehub/lint	lobehub/lobe-lint	LobeLint provides configurations for ESlint, Stylelint, Commitlint, Prettier, Remark, and Semantic Release for LobeHub.
@lobehub/assets	lobehub/assets	Logo assets, favicons, webfonts for LobeHub.

🧩 Plugins

Plugins provide a means to extend the Function Calling capabilities of LobeChat. They can be used to introduce new function calls and even new ways to render message results. If you are interested in plugin development, please refer to our 📘 Plugin Development Guide in the Wiki.

• lobe-chat-plugins: This is the plugin index for LobeChat. It accesses index.json from this repository to display a list of available plugins for LobeChat to the user.
• chat-plugin-template: This is the plugin template for LobeChat plugin development.
• @lobehub/chat-plugin-sdk: The LobeChat Plugin SDK assists you in creating exceptional chat plugins for Lobe Chat.
• @lobehub/chat-plugins-gateway: The LobeChat Plugins Gateway is a backend service that provides a gateway for LobeChat plugins. We deploy this service using Vercel. The primary API POST /api/v1/runner is deployed as an Edge Function.

[!NOTE]

The plugin system is currently undergoing major development. You can learn more in the following issues:

• Plugin Phase 1: Implement separation of the plugin from the main body, split the plugin into an independent repository for maintenance, and realize dynamic loading of the plugin.
• Plugin Phase 2: The security and stability of the plugin's use, more accurately presenting abnormal states, the maintainability of the plugin architecture, and developer-friendly.
• Plugin Phase 3: Higher-level and more comprehensive customization capabilities, support for plugin authentication, and examples.

Official Plugin	Repository	Description
Clock Time By LobeHub on 2023-11-01	lobehub/chat-plugin-clock-time	Display a clock to show current time clock time
Website Crawler By LobeHub on 2023-08-17	lobehub/chat-plugin-web-crawler	Extract content from web links web content-crawler
Search Engine By LobeHub on 2023-08-15	lobehub/chat-plugin-search-engine	Query search engine to get information web search
Realtime Weather By LobeHub on 2023-08-12	lobehub/chat-plugin-realtime-weather	Get realtime weather information weather realtime

📊 Total plugins: 4

⌨️ Local Development

You can use GitHub Codespaces for online development:

Or clone it for local development:

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

🤝 Contributing

Contributions of all types are more than welcome; if you are interested in contributing code, feel free to check out our GitHub Issues and Projects to get stuck in to show us what you’re made of.

🔗 More Products

• 🤯 Lobe Theme: The modern theme for Stable Diffusion WebUI, exquisite interface design, highly customizable UI, and efficiency-boosting features.
• 🌏 Lobe i18n : Lobe i18n is an automation tool for the i18n (internationalization) translation process, powered by ChatGPT. It supports features such as automatic splitting of large files, incremental updates, and customization options for the OpenAI model, API proxy, and temperature.
• 💌 Lobe Commit: Lobe Commit is a CLI tool that leverages Langchain/ChatGPT to generate Gitmoji-based commit messages.

---

📝 License

Copyright © 2023 LobeHub.
This project is MIT licensed.