cli-anything-chromadb 是做什麼的？
一個無狀態的命令列介面，用於 ChromaDB 向量資料庫，基於 HTTP API v2 構建。專為 AI 代理和高級使用者設計，無需瀏覽器 UI 即可管理集合、文件並執行語意查詢。
安裝
此 CLI 作為 cli-anything-chromadb 套件的一部分安裝：
pip install cli-anything-chromadb
先決條件：
- Python 3.10+
- ChromaDB 伺服器正在 localhost:8000 執行（或透過 --host 指定）
使用方式
基本指令
# 顯示說明
cli-anything-chromadb --help
# 啟動互動式 REPL 模式
cli-anything-chromadb
# 檢查伺服器健康狀態
cli-anything-chromadb --json server heartbeat
# 列出所有集合
cli-anything-chromadb --json collection list
# 語意搜尋
cli-anything-chromadb --json query search --collection hub_knowledge --text "如何部署"
REPL 模式
當不帶子指令執行時，CLI 會進入互動式 REPL 工作階段：
cli-anything-chromadb
# 以分頁補全和歷史記錄互動輸入指令
指令群組
server
伺服器健康和版本相關指令。
| 指令 | 說明 |
|---|---|
heartbeat | 檢查 ChromaDB 伺服器健康狀態 |
version | 取得 ChromaDB 伺服器版本 |
collection
管理 ChromaDB 集合。
| 指令 | 說明 |
|---|---|
list | 列出所有集合 |
create --name NAME | 建立新集合 |
delete --name NAME | 刪除集合 |
info NAME | 取得集合資訊 |
document
管理集合中的文件。
| 指令 | 說明 |
|---|---|
add --collection C --id ID --document TEXT | 新增文件 |
get --collection C | 取得文件 |
delete --collection C --id ID | 刪除文件 |
count --collection C | 計算文件數量 |
query
對集合進行語意搜尋。
| 指令 | 說明 |
|---|---|
search --collection C --text T | 語意搜尋 |
輸出格式
所有指令皆支援雙重輸出模式：
- 人類可讀（預設）：表格、色彩、格式化文字
- 機器可讀（
--json標誌）：結構化 JSON，供代理消耗
# 人類輸出
cli-anything-chromadb server heartbeat
# 供代理使用的 JSON 輸出
cli-anything-chromadb --json server heartbeat
給 AI 代理的提示
以程式方式使用此 CLI 時：
- 始終使用
--json標誌以取得可解析的輸出 - 檢查回傳碼 - 0 表示成功，非零表示錯誤
- 解析 stderr以取得失敗時的錯誤訊息
- **使用
--host**連接到非預設的 ChromaDB 實例
版本
1.0.0