[![][image-banner]][vercel-link]

LobeHub

LobeHub organizes your agents into 7×24 operation.

It hires, schedules, reports on your entire AI team.

You stay in charge — without staying online.

English · [简体中文](./README.zh-CN.md) · [Official Site][official-site] · [Changelog][changelog] · [Documents][docs] · [Blog][blog] · [Feedback][github-issues-link]

<!-- SHIELD GROUP -->

[![][github-release-shield]][github-release-link]
[![][docker-release-shield]][docker-release-link]
[![][vercel-shield]][vercel-link]
[![][discord-shield]][discord-link]
[![][codecov-shield]][codecov-link]
[![][github-action-test-shield]][github-action-test-link]
[![][github-action-release-shield]][github-action-release-link]
[![][github-releasedate-shield]][github-releasedate-link]
[![][github-contributors-shield]][github-contributors-link]
[![][github-forks-shield]][github-forks-link]
[![][github-stars-shield]][github-stars-link]
[![][github-issues-shield]][github-issues-link]
[![][github-license-shield]][github-license-link]

Share LobeHub Repository

[![][share-x-shield]][share-x-link]
[![][share-telegram-shield]][share-telegram-link]
[![][share-whatsapp-shield]][share-whatsapp-link]
[![][share-reddit-shield]][share-reddit-link]
[![][share-weibo-shield]][share-weibo-link]
[![][share-mastodon-shield]][share-mastodon-link]
[![][share-linkedin-shield]][share-linkedin-link]

Your Chief Agent Operator


Table of contents

TOC

• [👋🏻 Getting Started & Join Our Community](#-getting-started--join-our-community)
• [✨ Features](#-features)

- [Operator: Agents as the Unit of Work](#operator-agents-as-the-unit-of-work) - [Create: Agents as the Unit of Work](#create-agents-as-the-unit-of-work) - [Collaborate: Scale New Forms of Collaboration Networks](#collaborate-scale-new-forms-of-collaboration-networks) - [Evolve: Co-evolution of Humans and Agents](#evolve-co-evolution-of-humans-and-agents)

• [🛳 Self Hosting](#-self-hosting)

- [A Deploying with Vercel, Zeabur , Sealos or Alibaba Cloud](#a-deploying-with-vercel-zeabur--sealos-or-alibaba-cloud) - [B Deploying with Docker](#b-deploying-with-docker) - [Environment Variable](#environment-variable) - [Obtain OpenAI API Key](#obtain-openai-api-key)

• [📦 Ecosystem](#-ecosystem)
• [🧩 Plugins](#-plugins)
• [⌨️ Local Development](#️-local-development)
• [🤝 Contributing](#-contributing)
• [❤️ Sponsor](#️-sponsor)
• [🔗 More Products](#-more-products)

####

👋🏻 Getting Started & Join Our Community

We are a group of e/acc design-engineers, hoping to provide modern design components and tools for AIGC.
By adopting the Bootstrapping approach, we aim to provide developers and users with a more open, transparent, and user-friendly product ecosystem.

Whether for users or professional developers, LobeHub will be your AI Agent playground. Please be aware that LobeHub is currently under active development, and feedback is welcome for any [issues][issues-link] encountered.

|  | We are live on Product Hunt! We are thrilled to bring LobeHub to the world. If you believe in a future where humans and agents co-evolve, please support our journey. |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [![][discord-shield-badge]][discord-link] | 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 \~ ⭐️

[![][image-star]][github-stars-link]

Star History

✨ Features

Today’s agents are one-off, task-driven tools. They lack context, live in isolation, and require manual hand-offs between different windows and models. While some maintain memory, it is often global, shallow, and impersonal. In this mode, users are forced to toggle between fragmented conversations, making it difficult to form structured productivity.

LobeHub changes everything.

LobeHub is a work-and-lifestyle space to find, build, and collaborate with agent teammates that grow with you. In LobeHub, we treat Agents as the unit of work, providing an infrastructure where humans and agents co-evolve.


Operator: Agents as the Unit of Work

Hires, schedules, and reports on your entire AI team.

• More productivity. Fewer tools: Bring all your agents under one roof.
• IM Gateway: Agents where you already chat.


[![][back-to-top]](#readme-top)

[![][back-to-top]](#readme-top)


Create: Agents as the Unit of Work

Building a personalized AI team starts with the Agent Builder. You can describe what you need once, and the agent setup starts right away, applying auto-configurations so you can use it instantly.

• Unified Intelligence: Seamlessly access any model and any modality—all under your control.
• 10,000+ Skills: Connect your agents to the skills you use every day with a library of over 10,000 tools and MCP-compatible plugins.


[![][back-to-top]](#readme-top)

[![][back-to-top]](#readme-top)


Collaborate: Scale New Forms of Collaboration Networks

LobeHub introduces Agent Groups, allowing you to work with agents like real teammates. The system assembles the right agents for the task, enabling parallel collaboration and iterative improvement.

• Pages: Write and refine content with multiple agents in one place with a shared context.
• Schedule: Schedule runs and let agents do the work at the right time, even while you are away.
• Project: Organize work by project to keep everything structured and easy to track.
• Workspace: A shared space for teams to collaborate with agents, ensuring clear ownership and visibility across the organization.


[![][back-to-top]](#readme-top)

[![][back-to-top]](#readme-top)


Evolve: Co-evolution of Humans and Agents

The best AI is one that understands you deeply. LobeHub features Personal Memory that builds a clear understanding of your needs.

• Continual Learning: Your agents learn from how you work, adapting their behavior to act at the right moment.
• White-Box Memory: We believe in transparency. Your agents use structured, editable memory, giving you full control over what they remember.


[![][back-to-top]](#readme-top)

> ✨ more features will be added when LobeHub evolve.

[![][back-to-top]](#readme-top)

🛳 Self Hosting

LobeHub provides Self-Hosted Version with Vercel, Alibaba Cloud, and [Docker Image][docker-release-link]. This allows you to deploy your own chatbot within a few minutes without any prior knowledge.

> \[!TIP]
>
> Learn more about [📘 Build your own LobeHub][docs-self-hosting] by checking it out.

A Deploying with Vercel, Zeabur , Sealos or Alibaba Cloud

"If you want to deploy this service yourself on Vercel, Zeabur or Alibaba Cloud, you can follow these steps:

• Prepare your OpenAI API Key.
• Click the button below to start deployment: Log in directly with your GitHub account, and remember to fill in the OPENAI_API_KEY(required) 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.

| Deploy with Vercel | Deploy with Zeabur | Deploy with Sealos | Deploy with RepoCloud | Deploy with Alibaba Cloud |
| :-------------------------------------: | :---------------------------------------------------------: | :---------------------------------------------------------: | :---------------------------------------------------------------: | :-----------------------------------------------------------------------: |
| [![][deploy-button-image]][deploy-link] | [![][deploy-on-zeabur-button-image]][deploy-on-zeabur-link] | [![][deploy-on-sealos-button-image]][deploy-on-sealos-link] | [![][deploy-on-repocloud-button-image]][deploy-on-repocloud-link] | [![][deploy-on-alibaba-cloud-button-image]][deploy-on-alibaba-cloud-link] |

After Fork

After fork, only retain the upstream sync action and disable other actions in your repository on GitHub.

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, [📘 Auto Sync With Latest][docs-upstream-sync]

B Deploying with Docker

[![][docker-release-shield]][docker-release-link]
[![][docker-size-shield]][docker-size-link]
[![][docker-pulls-shield]][docker-pulls-link]

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

1. create a folder to for storage files

fish
$ mkdir lobehub-db && cd lobehub-db

2. init the LobeHub infrastructure

fish
bash <(curl -fsSL https://lobe.li/setup.sh)

3. Start the LobeHub service

fish
docker compose up -d

> \[!NOTE]
>
> For detailed instructions on deploying with Docker, please refer to the [📘 Docker Deployment Guide][docs-docker]

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 or https://aihubmix.com/v1 The default value ishttps://api.openai.com/v1 |
| OPENAI_MODEL_LIST | No | Used to control the model list. Use + to add a model, - to hide a model, and model_name=display_name to customize the display name of a model, separated by commas. | qwen-7b-chat,+glm-6b,-gpt-3.5-turbo |

> \[!NOTE]
>
> The complete list of environment variables can be found in the [📘 Environment Variables][docs-env-var]

Obtain OpenAI API Key

An API Key is required to chat with LLMs in LobeHub. This section uses the OpenAI model provider as an example to briefly introduce how to obtain an API Key.

A Via the Official OpenAI Channel

• Sign up for an OpenAI account; you will need an international phone number and a non-mainland-China email address;
• After signing up, go to the API Keys page and click Create new secret key to create a new API Key:

| Step 1: Open the creation dialog | Step 2: Create the API Key | Step 3: Get the API Key | | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | | <img src="http

…

Collapse