cli-anything-chromadb は何をしますか？
ChromaDBベクターデータベースのためのステートレスなコマンドラインインターフェースです。HTTP API v2上に構築されており、ブラウザUIを使わずにコレクション、ドキュメントの管理やセマンティッククエリを実行したいAIエージェントやパワーユーザー向けに設計されています。
インストール
この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モード
サブコマンドを指定せずに呼び出すと、対話型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 | セマンティック検索 |
出力形式
すべてのコマンドは2つの出力モードをサポートしています。
- 人間可読（デフォルト）: テーブル、色付き、フォーマット済みテキスト
- 機械可読（
--jsonフラグ）: エージェントが消費するための構造化JSON
# 人間向け出力
cli-anything-chromadb server heartbeat
# エージェント向けJSON出力
cli-anything-chromadb --json server heartbeat
AIエージェント向け
このCLIをプログラム的に使用する場合は:
- 常に
--jsonフラグ を使用して解析可能な出力を取得する - リターンコードを確認する - 0は成功、非0はエラー
- stderr を解析する - エラー時のメッセージ取得のため
--hostを使用する - デフォルト以外のChromaDBインスタンスに接続する場合
バージョン
1.0.0