Cli Anything Chromadb

by hkuds34f519533bc1No license51K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 weeks ago

Command-line interface for ChromaDB - A stateless CLI for managing vector database collections, documents, and semantic search. Designed for AI agents and automation via the ChromaDB HTTP API v2.

Instructions onlyData & Analytics
AI-generated overview

Stateless command-line interface for managing ChromaDB collections, documents, and semantic search.

What it does
This skill documents a command-line interface for a ChromaDB vector database, built on the ChromaDB HTTP API v2. It covers server health and version checks, collection creation, listing, deletion and inspection, document add, get, delete and count operations, and semantic search queries. Commands offer human-readable output by default and structured JSON output with the --json flag, plus an interactive REPL mode.
When to use it
Use it when an agent or power user needs to manage ChromaDB collections and documents or run semantic queries without a browser UI. It fits automation and scripted workflows that consume JSON output and return codes.
Requirements
Requires Python 3.10+ and a ChromaDB server reachable at localhost:8000 or a host given via --host. The package is installed with pip install cli-anything-chromadb. It ships no scripts; it is instructions only.

cli-anything-chromadb

A stateless command-line interface for ChromaDB vector database, built on the HTTP API v2. Designed for AI agents and power users who need to manage collections, documents, and run semantic queries without a browser UI.

Installation

This CLI is installed as part of the cli-anything-chromadb package:

bash
pip install cli-anything-chromadb

Prerequisites:

  • Python 3.10+
  • ChromaDB server running at localhost:8000 (or specify via --host)

Usage

Basic Commands

bash
# Show helpcli-anything-chromadb --help
# Start interactive REPL modecli-anything-chromadb
# Check server healthcli-anything-chromadb --json server heartbeat
# List all collectionscli-anything-chromadb --json collection list
# Semantic searchcli-anything-chromadb --json query search --collection hub_knowledge --text "How to deploy"

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

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

Command Groups

server

Server health and version commands.

CommandDescription
heartbeatCheck ChromaDB server health
versionGet ChromaDB server version

collection

Manage ChromaDB collections.

CommandDescription
listList all collections
create --name NAMECreate a new collection
delete --name NAMEDelete a collection
info NAMEGet collection info

document

Manage documents in collections.

CommandDescription
add --collection C --id ID --document TEXTAdd document(s)
get --collection CGet documents
delete --collection C --id IDDelete document(s)
count --collection CCount documents

query

Semantic search against collections.

CommandDescription
search --collection C --text TSemantic search

Output Formats

All commands support dual output modes:

  • Human-readable (default): Tables, colors, formatted text
  • Machine-readable (--json flag): Structured JSON for agent consumption
bash
# Human outputcli-anything-chromadb server heartbeat
# JSON output for agentscli-anything-chromadb --json server heartbeat

For AI Agents

When using this CLI programmatically:

  1. Always use --json flag for parseable output
  2. Check return codes - 0 for success, non-zero for errors
  3. Parse stderr for error messages on failure
  4. Use --host to connect to non-default ChromaDB instances

Version

1.0.0

Source and attribution

Source:hkuds/cli-anythinginskills/cli-anything-chromadbat commit34f5195

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal