npm | LibreChat

对于大多数场景，由于 Docker Compose 简单、易用且可靠，它是推荐的安装方式。如果您更喜欢使用 npm，可以按照这些说明进行操作。

先决条件

Node.js v24.16.0: https://nodejs.org/en/download
npm v11.16.0
- LibreChat 使用 CommonJS (CJS) 和 openid-client v6；Node 24 满足了所需的 CJS/ESM 互操作性、WebCrypto 和 Fetch API 运行时支持。
Git: https://git-scm.com/download/
MongoDB (Atlas 或 Community Server)
- MongoDB Atlas
- MongoDB Community Server

如果您使用 nvm，请安装并选择推荐的 Node.js 版本，然后更新 npm：

nvm install 24.16.0
nvm use 24.16.0
npm install -g [email protected]
node -v
npm -v

在安装 LibreChat 依赖项之前，你应该看到 Node.js 的版本为 v24.16.0，npm 的版本为 11.16.0。

在终端中运行以下命令：

git clone https://github.com/danny-avila/LibreChat.git

cd LibreChat

cp .env.example .env

注意： 如果您使用的是 Windows 10，您可能需要使用 copy 而不是 cp。

Important: Edit the newly created `.env` file to update the `MONGO_URI` with your own MongoDB instance URI.

更新 MONGO_URI

编辑新创建的 .env 文件，以使用您自己的 MONGO_URI 进行更新

完成准备步骤后，请运行以下命令：

npm run reinstall

npm run reinstall 执行干净的依赖安装并构建 LibreChat。在更改 Node.js 或 npm 版本后使用此命令，以便针对当前运行环境重新构建原生包。

npm run backend

访问 LibreChat！

提示

要将 LibreChat 更新至最新版本，请运行以下命令：

首先，停止 LibreChat（如果你还没有停止的话）。

git pull

npm run smart-reinstall

如果您在更新期间更改了 Node.js 或 npm 版本，请改为运行 npm run reinstall。

npm run backend

通过探索我们的配置指南来了解如何设置以下内容，从而解锁更多功能：

这将使您能够通过可选功能自定义您的 LibreChat 体验。

另请参阅：