PrivateGPT 是 GitHub 上星標超過 5.7 萬的開源項目,定位為「本地私有 AI 應用 API 層」,由 Zylon 團隊維護,採用 Apache 2.0 許可證。該項目的核心主張是:在本機運行模型只是第一步,要建構真正可用的 AI 應用,還需要一套標準化的高階元件——訊息 API、文件擷取、檢索引用、工具呼叫、資料庫存取與 MCP 連接——而 PrivateGPT 正是提供這一層的開放原始碼方案,且完全相容 OpenAI 協定的推理伺服器。

PrivateGPT 是一個星標超過 5.7 萬的開源專案,提供本地私有 AI 應用的標準 API 層,包含 RAG 檢索、工具呼叫、MCP 連接與資料庫存取能力。它不自行運行模型,而是連接 Ollama、vLLM 等 OpenAI 相容推理伺服器,採用 Apache 2.0 許可證。

PrivateGPT 是什麼?為什麼能獲得 5.7 萬星標?

PrivateGPT 起源於 2023 年一個病毒式傳播的概念驗證專案:一支能讓使用者完全離線與個人文件對話的腳本,資料不外傳、不需雲端依賴。該專案當年迅速突破 5 萬星標,成為年度最受矚目的 AI 儲存庫之一,也驗證了市場對「私有、本地、無雲端」AI 的強烈需求。2026 年推出的 PrivateGPT 1.0 是徹底重寫的版本,將原始概念從「一支對話腳本」升級為「完整的應用程式 API 層」。

PrivateGPT 從 2023 年的離線文件對話概念驗證專案起家,因滿足「資料不外傳」的私有 AI 需求而迅速突破 5 萬星標。1.0 版本徹底重寫為標準化 API 層,提供訊息、檢索、工具與資料庫能力,讓開發者不必從零重構後端基礎元件。

PrivateGPT README 開頭截圖,顯示項目名稱 PrivateGPT、標語 The open-source API layer that turns local models into production AI applications,以及描述其連接 Ollama、llama.cpp、vLLM 等推理伺服器的架構圖

PrivateGPT 受歡迎的原因可以歸結為三點:第一,它回答了「模型跑起來之後要做什麼」的關鍵問題,填補了本地推理引擎與最終應用之間的空缺;第二,它採用 Claude API 作為設計基準,讓熟悉現代 AI 應用介面的開發者可以無痛遷移;第三,它由 Zylon 這家專注私有 AI 基礎設施的公司持續維護,並已在企業環境中實際部署驗證,而非曇花一現的實驗專案。

PrivateGPT 與 Ollama、vLLM 等本地推理引擎有何不同?

這是理解 PrivateGPT 定位的關鍵問題。Ollama、LM Studio、LocalAI、vLLM 與 llama.cpp 解決的是「如何運行模型」的問題,它們屬於本地推理層;PrivateGPT 解決的是「如何在模型之上建構有用的 AI 應用」的問題,屬於本地 AI 應用 API 層。兩者並非競爭關係,而是互補關係:先以偏好的推理伺服器運行模型,再將 PrivateGPT 指向該伺服器即可。

PrivateGPT 與 Ollama、vLLM 等推理引擎並非競爭關係,而是互補:推理引擎負責運行模型,PrivateGPT 則提供在其上建構應用的 API 層,包含訊息、檢索、工具與資料庫能力。使用者可先以 Ollama 等伺服器跑模型,再將 PrivateGPT 指向該伺服器,兩者可疊加使用。

與 Onyx、Open WebUI 等自架 AI 應用相比,PrivateGPT 的差異同樣鮮明:後兩者是「應用優先」的成品,專注於聊天介面與企業搜尋體驗;PrivateGPT 則是「API 優先」的基礎層,提供標準化的本地後端,讓開發者在其上建構自己的產品,而非直接提供最終產品。官方文件以一句話概括:「PrivateGPT 是建構自架 AI 應用的 API 層,而不是應用本身。」

PrivateGPT 有哪些核心功能與 API 能力?

PrivateGPT 的功能清單覆蓋現代 AI 應用的主要構成元件。在訊息層面,它提供標準的 messages API,支援串流、 PrivateGPT 的功能清單覆蓋現代 AI 應用的主要構成元件。在訊息層面,它提供標準的 messages API,支援串流、非同步處理與 token 計數;在知識層面,它具備檔案與產物擷取、PDF 與文件解析、帶引用的檢索(retrieval with citations)與代理式 RAG(agentic RAG);在工具層面,內建鏡像 Claude API 的工具,包括網頁搜尋、網頁擷取與程式碼執行,同時支援自訂工具與 MCP 連接器。

PrivateGPT 提供完整 API 能力:標準 messages API(串流、非同步、token 計數)、文件擷取與帶引用的代理式 RAG、內建網頁搜尋與程式碼執行工具、自訂工具與 MCP 連接器,以及資料庫與 CSV 的結構化存取。內建 Workbench UI 可測試檢索與工具,API 本身才是核心產品。

資料層是 PrivateGPT 與多數開源方案的差異化優勢:它將資料庫查詢與 CSV/表格分析內建為標準能力,而非依賴工具或程式碼間接實現。官方相容性對照表顯示,PrivateGPT 在模型選擇、訊息 API、串流、token 計數、檔案產物、PDF 擷取、帶引用檢索、嵌入、工具使用、內建網頁搜尋、資料庫查詢、CSV 分析、MCP 與擴展思考(extended thinking)等項目上均與 Claude API 對齊,僅在提示快取與 OAuth/組織管理兩項尚未支援。

PrivateGPT GitHub 首頁頂部截圖,顯示 repo 名稱 zylon-ai/private-gpt、星標數 57.4k、分支數 7.6k、Apache-2.0 許可證與項目描述 Complete API layer for private AI applications on local models

PrivateGPT 如何整合 Claude 生態與 MCP?

PrivateGPT 最值得關注的設計決策是以 Claude API 作為相容性基準。這意味著開發者為 Claude 撰寫的應用程式邏輯, PrivateGPT 最值得關注的設計決策是以 Claude API 作為相容性基準。這意味著開發者為 Claude 撰寫的應用程式邏輯,可以透過替換 API 端點的方式指向本地模型,無需重寫整合程式碼。實際整合清單包括 Claude Code(以本地模型作為終端機代理編程後端)、Claude Desktop 與 Cowork(將桌面應用連接至私有模型),以及 Claude for Microsoft 365(在 Word、Excel、Outlook 與 PowerPoint 中運行私有 AI)。

PrivateGPT 以 Claude API 為相容基準,讓既有 Claude 應用邏輯可指向本地模型。它原生支援 Claude Code、Claude Desktop/Cowork 與 Microsoft 365 整合,同時提供 MCP 連接器與遠端 MCP 伺服器支援,任何相容 OpenAI 協定的工具(n8n、OpenCode、Cline 等)皆可接駁。

在協定層面,PrivateGPT 的 API 遵循 Anthropic API 規範,同時因為支援 OpenAI 相容推理伺服器,實際上形成雙協定兼容的架構:上游連接任何 OpenAI 相容的 /v1/chat/completions 與 /v1/models 端點,下游以 Claude 風格 API 對外服務。任何能與本地 OpenAI 相容供應商協作的工具,包括 n8n、OpenClaw、VS Code、Cline 與 Hermes Agent,都能直接搭配 PrivateGPT 使用,生態相容性相當廣泛。

PrivateGPT 支援哪些本地模型與部署方式?

PrivateGPT 本身不運行模型,而是透過 OPENAIAPIBASE 連接外部推理伺服器,只要該伺服器實作 /v1/chat/completions 與 PrivateGPT 本身不運行模型,而是透過 OPENAI_API_BASE 連接外部推理伺服器,只要該伺服器實作 /v1/chat/completions 與 /v1/models 即可運作。官方快速入門以 Ollama 為範例:拉取 qwen3.5:35b 作為主模型、mxbai-embed-large 作為嵌入模型,啟動 Ollama 伺服器後設定環境變數並執行 private-gpt serve 即可完成部署,內建 Workbench UI 位於 8080 埠的 /ui 路徑。

PrivateGPT 不自行運行模型,透過 OPENAI_API_BASE 連接任何 OpenAI 相容推理伺服器,包括 Ollama、llama.cpp 與 vLLM。安裝支援 macOS、Linux 與 Windows,可透過 Homebrew 或 uv 工具安裝,啟動後內建 Workbench UI 提供模型選擇、文件上傳與檢索測試功能。

安裝方式涵蓋三大桌面平台:macOS 可透過 Homebrew tap 安裝,Linux 與 Windows 則以 uv 工具安裝 private-gpt[core] 套件。內建 Workbench UI 雖定位為展示用途,但已足以應付示範影片、內部試點與快速本地使用:使用者可以發送訊息、從 /v1/models 選擇模型、上傳文件、測試帶引用的檢索、逐聊天啟用工具,並透過 API Debugger 檢視請求與回應。對需要完整圖形介面的團隊,則可搭配 Open WebUI 等應用層方案。

PrivateGPT 與 Zylon 的商業模式如何運作?

PrivateGPT 由 Zylon 團隊維護,其商業模式是典型的「開源核心+企業版」雙軌結構。PrivateGPT 是開放原始碼的應用 API 層, PrivateGPT 由 Zylon 團隊維護,其商業模式是典型的「開源核心+企業版」雙軌結構。PrivateGPT 是開放原始碼的應用 API 層,免費提供訊息、擷取、工具、檢索、資料庫、MCP 與技能等能力;Zylon 則是在其上建構的端對端企業 AI 基礎設施平台,針對受監管產業提供整合推理伺服器(基於 NVIDIA Triton 與 vLLM)、Kubernetes 自含部署、並行與批次處理、負載平衡、LDAP/Active Directory 整合、RBAC 使用者管理、SIEM 稽核日誌與斷網(air-gapped)運作能力。

PrivateGPT 與 Zylon 形成開源核心加企業版的商業結構:PrivateGPT 免費提供本地 AI 應用 API 層,Zylon 則提供企業級基礎設施,包括 NVIDIA Triton 整合推理、Kubernetes 部署、LDAP/AD 與 RBAC、SIEM 稽核與斷網運作。企業用戶可在 PrivateGPT 上快速試點,再升級至 Zylon 取得治理與支援。

這套結構的商業邏輯清晰:PrivateGPT 作為開源入口,讓開發者與企業以零成本驗證本地 AI 應用可行性;一旦進入生產規模,Zylon 提供的並行處理、稽核、身分管理與技術支援便成為升級誘因。對受監管產業(金融、醫療、政府)而言,資料不出境與 SIEM 稽核日誌是合規剛需,Zylon 正是瞄準這一缺口設計產品。官方文件明確建議:需要開源本地 AI 應用層的團隊使用 PrivateGPT,需要完整企業基礎設施的組織選擇 Zylon。

PrivateGPT 的關鍵數據有哪些?

PrivateGPT 截至 2026 年 8 月獲 57,446 星標與 7,610 分支,採 Apache-2.0 授權、主要語言 Python,2023 年 5 月建立、2026 年 8 月 15 日最近更新,屬活躍維護的開源項目。

57,446
GitHub 星標
7,610
分支數(Forks)
Apache-2.0
開源許可證
Python
主要語言
2023-05
建立時間
2026-08-15
最近更新

PrivateGPT 值得一試嗎?適合哪些場景?

PrivateGPT 適合三類場景。第一類是重視資料隱私的企業與個人:金融、醫療、法律等產業的敏感資料不允許送往雲端 API,PrivateGPT 搭配本地模型可實現完全離線的知識庫問答,官方描述的 Zylon 客戶即涵蓋全球受監管企業。第二類是希望以標準 API 建構 AI 應用的開發團隊:Claude API 相容設計讓既有整合無痛轉向本地部署,RAG、工具與資料庫能力一次到位,省去重構後端的成本。

PrivateGPT 值得一試,特別適合資料敏感的企業(金融、醫療、法律)與希望標準化建構 AI 應用的開發團隊。它提供離線知識庫問答、Claude API 相容介面與內建資料庫能力,Apache 2.0 授權零成本導入。搭配 Zylon 可升級至企業級治理與稽核,試點門檻低。

第三類是已投資本地推理基礎設施的組織:若團隊已運行 Ollama、vLLM 或 llama.cpp,PrivateGPT 可以立即疊加應用層價值,無需更動既有模型部署。需要留意的是,PrivateGPT 定位為 API 層而非成品應用,希望「開箱即用的聊天介面」的使用者可能更適合 Open WebUI 等應用優先方案;此外,部分進階功能(如提示快取、OAuth 組織管理)仍標示為未支援,企業用戶需自行評估差距。

PrivateGPT Contributors 統計頁截圖,顯示 Insights 分頁中 Contributors 頁面的 Commits over time 柱狀圖,統計過去三個月 main 分支的提交趨勢

出處連結有哪些?

本文資料來源為 PrivateGPT 官方 GitHub 儲存庫,包含 README 文件、相容性對照表與架構說明。 本文資料來源為 PrivateGPT 官方 GitHub 儲存庫,包含 README 文件、相容性對照表與架構說明。讀者可前往 github.com/zylon-ai/private-gpt 查看原始碼與最新更新,亦可瀏覽 PrivateGPT 官方文件網站 取得完整安裝指南與 API 參考,以及 Zylon 官方網站 了解企業版方案。

本文資訊來自 PrivateGPT 官方 GitHub 儲存庫(github.com/zylon-ai/private-gpt)、官方文件網站(docs.privategpt.dev)與 Zylon 官網。讀者可透過官方管道查閱原始碼、API 參考與企業版資訊,確保使用指引與最新功能保持一致。

總結:PrivateGPT 的本地 AI 應用之路如何走下去?

PrivateGPT 的發展歷程反映了本地 AI 市場的成熟過程:從 2023 年滿足「離線對話」需求的病毒式腳本,進化為 2026 年覆蓋 RAG、工具、MCP 與資料庫能力的標準化 API 層,背後是 Zylon 團隊持續的產品化投入與企業客戶的實戰驗證。5.7 萬星標證明了開發者對「私有 AI 應用層」這一空缺的認可,而 Claude API 相容設計則降低了採用門檻,讓既有生態工具得以直接接駁。

PrivateGPT 從 2023 年的離線對話概念驗證,進化為 2026 年覆蓋 RAG、工具、MCP 與資料庫的標準化 API 層,以 5.7 萬星標站穩本地 AI 應用層定位。未來關鍵在於開源核心與 Zylon 企業版的平衡,以及提示快取等進階功能的補齊,值得持續關注。