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로 지정)
사용법
기본 명령어
# 도움말 보기
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은 성공, 0이 아닌 값은 오류를 의미합니다
- stderr 파싱 - 실패 시 오류 메시지를 확인하세요
--host사용 - 기본이 아닌 ChromaDB 인스턴스에 연결하세요
버전
1.0.0