¿Qué hace cli-anything-chromadb?
Interfaz de línea de comandos sin estado para la base de datos vectorial ChromaDB, construida sobre la API HTTP v2. Diseñada para agentes de IA y usuarios avanzados que necesitan gestionar colecciones, documentos y ejecutar consultas semánticas sin un navegador.
Instalación
Esta CLI se instala como parte del paquete cli-anything-chromadb:
pip install cli-anything-chromadb
Prerrequisitos:
- Python 3.10+
- Servidor ChromaDB ejecutándose en localhost:8000 (o especificar mediante --host)
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-chromadb --help
# Iniciar modo REPL interactivo
cli-anything-chromadb
# Verificar estado del servidor
cli-anything-chromadb --json server heartbeat
# Listar todas las colecciones
cli-anything-chromadb --json collection list
# Búsqueda semántica
cli-anything-chromadb --json query search --collection hub_knowledge --text "How to deploy"
Modo REPL
Cuando se invoca sin un subcomando, la CLI inicia una sesión REPL interactiva:
cli-anything-chromadb
# Ingrese comandos de forma interactiva con autocompletado e historial
Grupos de comandos
server
Comandos de estado y versión del servidor.
| Comando | Descripción |
|---|---|
heartbeat | Verificar estado del servidor ChromaDB |
version | Obtener versión del servidor ChromaDB |
collection
Gestionar colecciones de ChromaDB.
| Comando | Descripción |
|---|---|
list | Listar todas las colecciones |
create --name NOMBRE | Crear una nueva colección |
delete --name NOMBRE | Eliminar una colección |
info NOMBRE | Obtener información de la colección |
document
Gestionar documentos en colecciones.
| Comando | Descripción |
|---|---|
add --collection C --id ID --document TEXTO | Agregar documento(s) |
get --collection C | Obtener documentos |
delete --collection C --id ID | Eliminar documento(s) |
count --collection C | Contar documentos |
query
Búsqueda semántica contra colecciones.
| Comando | Descripción |
|---|---|
search --collection C --text T | Búsqueda semántica |
Formatos de salida
Todos los comandos admiten dos modos de salida:
- Legible para humanos (predeterminado): tablas, colores, texto formateado
- Legible para máquinas (bandera
--json): JSON estructurado para consumo por agentes
# Salida humana
cli-anything-chromadb server heartbeat
# Salida JSON para agentes
cli-anything-chromadb --json server heartbeat
Para agentes de IA
Al usar esta CLI de forma programática:
- Siempre use la bandera
--jsonpara obtener salida analizable - Verifique los códigos de retorno: 0 para éxito, distinto de cero para errores
- Analice stderr para mensajes de error en caso de fallo
- Use
--hostpara conectarse a instancias de ChromaDB no predeterminadas
Versión
1.0.0