cli-anything-chromadb

cli-anything-chromadb

ChromaDB ベクトルデータベース用のステートレスなコマンドラインインターフェースで、HTTP API v2 上に構築されています。ブラウザ UI なしでコレクションやドキュメントを管理し、セマンティッククエリを実行する必要がある AI エージェントやパワーユーザー向けに設計されています。

インストール

この CLI は cli-anything-chromadb パッケージの一部としてインストールされます:

pip install cli-anything-chromadb

前提条件:

• Python 3.10+
• localhost:8000 で実行中の ChromaDB サーバー（または --host で指定）

使用方法

基本コマンド

# Show help
cli-anything-chromadb --help

# Start interactive REPL mode
cli-anything-chromadb

# Check server health
cli-anything-chromadb --json server heartbeat

# List all collections
cli-anything-chromadb --json collection list

# Semantic search
cli-anything-chromadb --json query search --collection hub_knowledge --text "How to deploy"

REPL モード

サブコマンドを指定せずに起動すると、CLI は対話型 REPL セッションに入ります:

cli-anything-chromadb
# Enter commands interactively with tab-completion and history

コマンドグループ

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	セマンティック検索

出力形式

すべてのコマンドは 2 つの出力モードをサポートしています:

• 人間が読みやすい形式（デフォルト）: テーブル、色、整形されたテキスト
• 機械が読み取れる形式（--json フラグ）: エージェントが利用するための構造化 JSON

# Human output
cli-anything-chromadb server heartbeat

# JSON output for agents
cli-anything-chromadb --json server heartbeat

AI エージェント向け

この CLI をプログラムから使用する場合:

1. 必ず --json フラグを使用する - 解析可能な出力のため
2. リターンコードを確認する - 0 は成功、非ゼロはエラー
3. 失敗時は stderr を解析する - エラーメッセージを取得するため
4. --host を使用する - デフォルト以外の ChromaDB インスタンスに接続するため

バージョン

1.0.0