Chroma（ChromaDB）是什麼、怎麼用：幾行代碼就能跑起來的開源向量數據庫

本文根據 Chroma 官方 GitHub 倉庫 README 整理，資料核對於 2026-10-11。開源項目變化快，以官方倉庫為準。

是什麼

Chroma（很多教學裏叫 ChromaDB）是一個開源向量數據庫，README 稱它是「面向 AI 的開源數據基礎設施」，倉庫簡介寫的是「AI 的搜尋基礎設施」。在各種 RAG 入門教學裏它出鏡率很高，原因是上手門檻低：裝一個 Python 包，不用起任何服務，就能在本機存向量、做相似度檢索。倉庫約有 2.95 萬星標，採用 Apache 2.0 許可。

能做什麼

README 列出的特性：

• 極簡的核心 API：只有四個函數——創建集合、添加文檔、查詢、按 ID 獲取。
• 自動處理嵌入：直接把文本交給它，它會自動分詞、生成嵌入並建立索引；也可以傳入自己算好的向量。
• 過濾查詢：按元數據過濾，也可以按文檔內容過濾。
• 多種運行模式：做原型時用內存模式，需要儲存時開啟持久化，多人或多服務共用時用客戶端-伺服器模式。
• Chroma Cloud：官方託管服務，提供無伺服器的向量檢索、混合檢索和全文檢索。

怎麼上手

README 給出的命令：

bash
pip install chromadb                    # Python 客戶端
npm install chromadb                    # JavaScript
chroma run --path /chroma_db_path       # 客戶端-伺服器模式

基本流程是：創建一個集合，把文檔（連同可選的元數據和 ID）添加進去，再用一段查詢文本取回最相似的若干條。四個函數的具體寫法見官方文檔的入門示例。

想直接用託管版，README 稱在 Chroma Cloud 上不到 30 秒就能建好數據庫並開始試用。

免費與付費

開源版本免費，可在本機或自己的伺服器上運行。Chroma Cloud 提供 5 美元的免費額度，之後的計費方式以官網為準。使用預設嵌入模型之外的服務（如各家的嵌入 API）時，費用由對應廠商收取。

適合誰 / 不適合誰

適合： 學習 RAG、想在筆記本電腦上快速跑通示例的初學者；數據量不大的個人項目和內部工具；需要把向量庫嵌進應用進程的開發者。

不適合： 不寫代碼的用戶；需要多副本高可用、數據量極大的生產系統（應評估 Chroma Cloud 或其他分佈式方案）；已有 Postgres 並希望少維護一個組件的團隊。

注意事項

• 內存模式下數據在進程結束後就沒了，正式使用要開啟持久化並做好備份。
• 更換嵌入模型後，舊向量和新向量不能混在同一個集合裏檢索。
• 以客戶端-伺服器模式部署時，自己負責訪問控制，不要把端口直接開放到公網。