跳至主要內容
PentAGI
開始使用

快速入門

使用互動式安裝程式安裝 PentAGI — 系統需求、下載、引導設定 providers 和 search engines,以及首次登入。

系統需求

  • Docker Engine 20 或更新版本,並搭配 Docker Compose;若使用 Podman,請手動安裝
  • 至少 2 vCPU 與 4 GB RAM
  • 25 GB 可用磁碟空間
  • 需具備網際網路連線以下載映像檔與更新

下載安裝程式

安裝程式是一個終端機使用者介面,可檢查您的系統、設定 providers 與 search engines、強化安全性並部署堆疊。

平台封存檔
Linux amd64installer-latest.zip
Linux arm64installer-latest.zip
Windows amd64installer-latest.zip
macOS Intelinstaller-latest.zip
macOS Apple siliconinstaller-latest.zip

macOS 版本已簽署並經過公證。若 macOS 仍封鎖安裝程式,請勿略過警告:請從上述連結重新下載符合您 CPU 架構的壓縮檔。

先觀看示範

您可以在 asciinema 上觀看安裝程式運作的終端機錄影。

執行安裝程式

mkdir -p ~/pentagi && cd ~/pentagi
uname -sm | sed -e 's,Linux ,linux/,' -e 's,Darwin ,darwin/,' -e s/x86_64/amd64/ -e s/aarch64/arm64/ | xargs -I PLATFORM curl -fLo installer.zip https://pentagi.com/downloads/PLATFORM/installer-latest.zip
unzip -o installer.zip
sudo ./installer

安裝程式透過 /var/run/docker.sock 與 Docker API 通訊,因此需要 root 權限或屬於 docker 群組的使用者:

sudo usermod -aG docker $USER
newgrp docker
docker ps

加入 docker 群組等同於擁有 root 權限。請僅授予受信任的使用者;在生產環境中,建議以 sudo 執行安裝程式或使用無根 Docker。

安裝程式會依序引導您完成以下步驟:

系統檢查 — 驗證 Docker、網路連線與系統需求。

環境設定 — 建立包含合理預設值的 .env 檔案。

LLM providers — OpenAI、Anthropic、Gemini、Bedrock、Ollama、DeepSeek、GLM、Kimi、Qwen、MiniMax、Mistral、xAI 或自訂端點。

Search engines — DuckDuckGo、Google、Tavily、Firecrawl、Traversaal、Perplexity、Sploitus、SearXNG。

安全強化 — 產生存取憑據與 SSL 憑證。

部署 — 使用 Docker Compose 啟動堆疊。

登入

開啟 https://localhost:8443 並以預設帳號 [email protected] / admin 登入,然後變更密碼。

網頁介面與其他服務皆繫結至 localhost,但每個 flow 的 sandbox 會在 Docker 主機的所有介面上發布兩個回呼埠,預設範圍為 28000–29999,且 ufw 不會過濾這些埠。若其他使用者可存取該主機,請先限制該範圍 — 請參閱 網路暴露。接著請繼續閱讀您的第一個 flow;若要稍後更新安裝,請遵循 升級。

最後更新於