使用 Eigent 建立完全本地化 AI 工作團隊指南

如果你正在尋找強大的 AI 工具，你很可能已經遇到一個關鍵挑戰：如何在不犧牲敏感資料安全性的情況下，釋放它們的全部潛力。

多數平台會把所有內容都送上雲端，起初雖然很方便，但當你處理客戶資料、財務數據或內部智慧財產時，很快就會亮起警訊。你想要多代理系統的強大能力，但你也想要隱私、掌控權，以及在自己的機器上執行一切的能力。

這就是 Eigent 的用武之地——透過 Eigent open source cowork，你可以建立一個完全本地化的多代理工作團隊，全部都運行在你自己的基礎架構上。

什麼是 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 建立 volume，因此資料庫檔案會儲存在磁碟上。

2. 驗證本地資料儲存

此時，一切都在本地執行。PostgreSQL 容器（eigent_postgres）保存著資料庫。你可以透過列出 Docker 容器，或是在容器內使用像 psql 這類工具來確認。Eigent 所做的一切（代理訊息、使用者資料、任務日誌等）都會寫入那個本地 Postgres 執行個體。任何資料都不會送到你機器以外的地方。

所有 Eigent 資料都會儲存在本地的 Dockerized 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 觀看