使用 Eigent 构建完全本地化 AI 团队指南

如果你正在寻找部署强大的 AI 工具，你可能已经遇到过一个关键挑战：如何在不损害敏感数据安全性的前提下，释放它们的全部潜力。

大多数平台都会把一切都推向云端，起初这看起来很方便，但当你处理客户记录、财务数据或内部知识产权时，很快就会引发警惕。你既想要多智能体系统的能力，也想要隐私、控制权，以及在自己机器上运行一切的能力。

这就是 Eigent 的用武之地——借助 Eigent 开源协作，你可以构建一个完全本地化、完全运行在你自己的基础设施上的多智能体团队。

什么是 Eigent？

Eigent 是一款本地优先的多智能体桌面应用。它不会把你的数据发送到外部服务器，而是在你的电脑上运行一切。你可以完整看到正在发生什么，并确信你的文件、凭证和日志都留在你自己的设备上。

你可以把它理解为在构建你自己的 AI 团队。你可以启动不同的智能体，每个智能体都拥有各自的技能：搜索智能体负责全网检索，开发者智能体负责运行代码，文档智能体负责编写和编辑文件，甚至还有能够处理图像和音频的多模态智能体。Eigent 会为你协调它们，使它们能够并行处理任务、在需要时进行交接，并交付精致的结果。

在本指南中，我们将准确展示如何在本地完成设置。到最后，你将让 Eigent 在你的桌面上运行起来，并配好可按你的方式协同工作的智能体。

前提条件

Node.js（v18 或更高版本）和 npm：Eigent 是一个 Node/Electron 应用。如果你还没有安装，请先安装 Node.js（建议 18–22）。 内存和硬件：建议至少 8 GB RAM。如果你连接的是外部 API，Eigent 可以完全在 CPU 上运行。对于本地大模型推理，更强大的 GPU（例如 NVIDIA RTX）会更有帮助。 操作系统：Eigent 支持 Windows 和 macOS。 Docker：安装 Docker 并确保它正在运行。https://docs.docker.com/get-docker/ ‍

1. 克隆仓库并启动 PostgreSQL 后端

克隆 Eigent 仓库并安装依赖：

git clone https://github.com/eigent-ai/eigent.git
cd eigent

切换到 server 目录并启动 Docker：

cd server
cp .env.example .env
docker compose up -d

这会启动两个容器：

一个 PostgreSQL 数据库（Eigent 数据存储） Eigent API 服务器 这两者都在你的机器本地运行，API 地址为 localhost:3001。默认情况下，Docker 会为 PostgreSQL 创建一个卷，因此数据库文件会存储在磁盘上。

2. 验证本地数据存储

此时，一切都在本地运行。PostgreSQL 容器（eigent_postgres）保存着数据库。你可以通过列出 Docker 容器，或者在容器内部使用 psql 之类的工具进行检查。Eigent 所做的一切（智能体消息、用户数据、任务日志等）都会写入这个本地 Postgres 实例。没有任何数据会被发送到你机器之外的地方。

所有 Eigent 数据都存储在本地 Docker 化的 PostgreSQL 数据库中。

这确保了默认隐私保护。正如文档所述，自托管的一个关键优势就是数据隐私——你将敏感数据保留在自己的基础设施内。事实上，当你使用这套配置时，任何工作区或登录信息都不会离开你的本地网络。Eigent 默认就是完全本地化的，因此你可以审计并信任你的数据会留在原地。

3. 修改 .env.development 以使用本地代理

接下来，我们需要告诉前端改用本地后端，而不是任何云服务。在项目根目录 (eigent/.env.development) 中，启用本地代理设置。用文本编辑器打开 .env.development，并确保其中包含：

VITE_BASE_URL=/api
VITE_PROXY_URL=http://localhost:3001
VITE_USE_LOCAL_PROXY=true

通过将 VITE_USE_LOCAL_PROXY=true 并把 VITE_PROXY_URL 指向 http://localhost:3001，你就配置了前端将所有 API 调用发送到本地 Docker 后端。

请确保这些行前面没有 # 或注释标记，否则它们不会生效。完成这个配置后，前端应用会将请求代理到你的本地服务器，而不是外部演示 API。

4. 运行前端应用

现在返回仓库根目录，安装 JavaScript 依赖，然后启动开发服务器：

cd ..
npm install
npm run dev

这将本地启动 Eigent 前端。默认情况下，它运行在 http://localhost:3000。配合 .env 的修改，前端会与 http://localhost:3001 上的 API 通信——全部都在你的机器内完成。

> eigent@* dev
> vite

  VITE vX.X.X  ready in Y ms

  ➜  Local:   http://localhost:3000/

这里不需要任何特殊的云端凭证——这只是一个普通的 Node 开发构建。

5. 在本地访问 Eigent UI

Eigent 的登录界面会加载出来，并且是本地托管的。虽然需要登录，但这个实例是自托管的，不涉及任何外部服务。

这个登录过程纯粹是为了本地应用——你的凭证和数据会保存在你启动的本地 Postgres 数据库中，而不是某个云服务器上。即使 UI 展示的是类似 OAuth 的登录界面，所有身份验证和用户数据都在你的机器上。文档强调了这种本地优先的设置：“你的数据保留在你自己的设备上，解决隐私和安全问题”。登录后，你将进入主控制面板，在那里你可以创建自定义智能体、定义工作流并配置工具。

例如，工具/设置页面允许你启用或禁用内置集成（网页搜索、Google docs、Slack 等），模型选择界面则让你选择或配置偏好的 LLM。从这里开始的一切——智能体消息、工具输出、知识库——都将保留在你的 PostgreSQL 数据库和本地文件系统中，除非你明确导出它们。

Eigent UI 允许你在本地实例上配置集成工具（Slack、网页搜索等）。在本地 Eigent 设置中，选择智能体要使用的模型或 API。

注意：在本地模式下，用户需要自行为模型配置 API 密钥或端点。

观看完整教程

更喜欢视频指南？我们已经录制了一段分步演示，带你走完整个过程，从启动 Docker 到本地登录 Eigent。

教程链接：在 YouTube 上观看