LobeHub Project Overview

Project Description

Open-source, modern-design AI Agent Workspace: LobeHub (previously LobeChat).

Supported platforms:

• Web desktop/mobile

• Desktop (Electron)

• Mobile app (React Native) - coming soon

Logo emoji: 🤯

Complete Tech Stack

Category Technology

Framework Next.js 16 + React 19

Routing SPA inside Next.js with react-router-dom

Language TypeScript

UI Components @lobehub/ui , antd

CSS-in-JS antd-style

Icons lucide-react, @ant-design/icons

i18n react-i18next

State zustand

URL Params nuqs

Data Fetching SWR

React Hooks aHooks

Date/Time dayjs

Utilities es-toolkit

API TRPC (type-safe)

Database Neon PostgreSQL + Drizzle ORM

Testing Vitest

Complete Project Structure

Monorepo using @lobechat/ namespace for workspace packages.

lobehub/ ├── apps/ │ └── desktop/ # Electron desktop app ├── docs/ │ ├── changelog/ │ ├── development/ │ ├── self-hosting/ │ └── usage/ ├── locales/ │ ├── en-US/ │ └── zh-CN/ ├── packages/ │ ├── agent-runtime/ # Agent runtime │ ├── builtin-agents/ │ ├── builtin-tool-*/ # Builtin tool packages │ ├── business/ # Cloud-only business logic │ │ ├── config/ │ │ ├── const/ │ │ └── model-runtime/ │ ├── config/ │ ├── const/ │ ├── context-engine/ │ ├── conversation-flow/ │ ├── database/ │ │ └── src/ │ │ ├── models/ │ │ ├── schemas/ │ │ └── repositories/ │ ├── desktop-bridge/ │ ├── edge-config/ │ ├── editor-runtime/ │ ├── electron-client-ipc/ │ ├── electron-server-ipc/ │ ├── fetch-sse/ │ ├── file-loaders/ │ ├── memory-user-memory/ │ ├── model-bank/ │ ├── model-runtime/ │ │ └── src/ │ │ ├── core/ │ │ └── providers/ │ ├── observability-otel/ │ ├── prompts/ │ ├── python-interpreter/ │ ├── ssrf-safe-fetch/ │ ├── types/ │ ├── utils/ │ └── web-crawler/ ├── src/ │ ├── app/ │ │ ├── (backend)/ │ │ │ ├── api/ │ │ │ ├── f/ │ │ │ ├── market/ │ │ │ ├── middleware/ │ │ │ ├── oidc/ │ │ │ ├── trpc/ │ │ │ └── webapi/ │ │ ├── spa/ # SPA HTML template service │ │ └── [variants]/ │ │ └── (auth)/ # Auth pages (SSR required) │ ├── routes/ # SPA page components (Vite) │ │ ├── (main)/ │ │ ├── (mobile)/ │ │ ├── (desktop)/ │ │ ├── onboarding/ │ │ └── share/ │ ├── spa/ # SPA entry points and router config │ │ ├── entry.web.tsx │ │ ├── entry.mobile.tsx │ │ ├── entry.desktop.tsx │ │ └── router/ │ ├── business/ # Cloud-only (client/server) │ │ ├── client/ │ │ ├── locales/ │ │ └── server/ │ ├── components/ │ ├── config/ │ ├── const/ │ ├── envs/ │ ├── features/ │ ├── helpers/ │ ├── hooks/ │ ├── layout/ │ │ ├── AuthProvider/ │ │ └── GlobalProvider/ │ ├── libs/ │ │ ├── better-auth/ │ │ ├── oidc-provider/ │ │ └── trpc/ │ ├── locales/ │ │ └── default/ │ ├── server/ │ │ ├── featureFlags/ │ │ ├── globalConfig/ │ │ ├── modules/ │ │ ├── routers/ │ │ │ ├── async/ │ │ │ ├── lambda/ │ │ │ ├── mobile/ │ │ │ └── tools/ │ │ └── services/ │ ├── services/ │ ├── store/ │ │ ├── agent/ │ │ ├── chat/ │ │ └── user/ │ ├── styles/ │ ├── tools/ │ ├── types/ │ └── utils/ └── e2e/ # E2E tests (Cucumber + Playwright)

Architecture Map

Layer Location

UI Components src/components , src/features

SPA Pages src/routes/

React Router src/spa/router/

Global Providers src/layout

Zustand Stores src/store

Client Services src/services/

REST API src/app/(backend)/webapi

tRPC Routers src/server/routers/{async|lambda|mobile|tools}

Server Services src/server/services (can access DB)

Server Modules src/server/modules (no DB access)

Feature Flags src/server/featureFlags

Global Config src/server/globalConfig

DB Schema packages/database/src/schemas

DB Model packages/database/src/models

DB Repository packages/database/src/repositories

Third-party src/libs (analytics, oidc, etc.)

Builtin Tools src/tools , packages/builtin-tool-*

Cloud-only src/business/* , packages/business/*

Data Flow

React UI → Store Actions → Client Service → TRPC Lambda → Server Services → DB Model → PostgreSQL