Architecture du projet

Vue d'ensemble de la structure de l'espace de travail monorepo de LibreChat et des limites des paquets.

Structure du Monorepo

LibreChat est organisé sous forme de monorepo avec des limites d'espace de travail clairement définies :

Espace de travail	Langage	Côté	Dépendance	Objectif
`/api`	JS (hérité)	Backend	`packages/api`, `packages/data-schemas`, `packages/data-provider`, `@librechat/agents`	Serveur Express — minimiser les changements ici
`/packages/api`	TypeScript	Backend	`packages/data-schemas`, `packages/data-provider`	Le nouveau code backend réside ici (TS uniquement, consommé par `/api`)
`/packages/data-schemas`	TypeScript	Backend	`packages/data-provider`	Modèles/schémas de base de données, partageables entre les projets backend
`/packages/data-provider`	TypeScript	Partagé	—	Types d'API partagés, endpoints, data-service — utilisés à la fois par le frontend et le backend
`/client`	TypeScript/React	Frontend	`packages/data-provider`, `packages/client`	SPA Frontend
`/packages/client`	TypeScript	Frontend	`packages/data-provider`	Utilitaires frontend partagés

Tout nouveau code backend doit être en TypeScript dans /packages/api.
Gardez les changements dans /api au strict minimum — de légers wrappers JS appelant /packages/api.
La logique partagée spécifique à la base de données se trouve dans /packages/data-schemas.
La logique API partagée entre le frontend et le backend (endpoints, types, data-service) se trouve dans /packages/data-provider.

Commande	Objectif
`npm run smart-reinstall`	Installe les dépendances (si le fichier lock a changé) + build via Turborepo
`npm run reinstall`	Installation propre après un changement de version de Node/npm ou lorsque l'état des dépendances est suspect
`npm run build`	Build tout le code compilé via Turborepo (parallèle, mis en cache)
`npm run frontend`	Build tout le code compilé séquentiellement (solution de repli héritée)
`npm run build:data-provider`	Reconstruit `packages/data-provider` après des modifications
`npm run backend`	Démarre le serveur backend
`npm run backend:dev`	Démarre le backend avec surveillance des fichiers (développement)
`npm run frontend:dev`	Démarre le serveur de développement frontend avec HMR (port 3090, nécessite que le backend soit en cours d'exécution)

Node.js : v24.16.0
npm : v11.16.0
Base de données : MongoDB
Le backend s'exécute sur http://localhost:3080/ ; le serveur de développement frontend sur http://localhost:3090/

Note

Pour l'ensemble complet des normes et conventions de codage, consultez Code Standards and Conventions.