cli-anything-chromadb

O que cli-anything-chromadb faz?

Uma interface de linha de comando sem estado para o banco de dados vetorial ChromaDB, construída sobre a API HTTP v2. Projetada para agentes de IA e usuários avançados que precisam gerenciar coleções, documentos e executar consultas semânticas sem um navegador.

Instalação

Esta CLI é instalada como parte do pacote cli-anything-chromadb:

pip install cli-anything-chromadb

Pré-requisitos:

• Python 3.10+
• Servidor ChromaDB rodando em localhost:8000 (ou especifique via --host)

Uso

Comandos Básicos

# Mostrar ajuda
cli-anything-chromadb --help

# Iniciar modo REPL interativo
cli-anything-chromadb

# Verificar saúde do servidor
cli-anything-chromadb --json server heartbeat

# Listar todas as coleções
cli-anything-chromadb --json collection list

# Busca semântica
cli-anything-chromadb --json query search --collection hub_knowledge --text "Como implantar"

Modo REPL

Quando invocado sem um subcomando, a CLI entra em uma sessão REPL interativa:

cli-anything-chromadb
# Insira comandos interativamente com autocompletação e histórico

Grupos de Comandos

server

Comandos de saúde e versão do servidor.

Comando	Descrição
heartbeat	Verificar saúde do servidor ChromaDB
version	Obter versão do servidor ChromaDB

collection

Gerenciar coleções do ChromaDB.

Comando	Descrição
list	Listar todas as coleções
create --name NOME	Criar uma nova coleção
delete --name NOME	Excluir uma coleção
info NOME	Obter informações da coleção

document

Gerenciar documentos em coleções.

Comando	Descrição
add --collection C --id ID --document TEXTO	Adicionar documento(s)
get --collection C	Obter documentos
delete --collection C --id ID	Excluir documento(s)
count --collection C	Contar documentos

query

Busca semântica em coleções.

Comando	Descrição
search --collection C --text T	Busca semântica

Formatos de Saída

Todos os comandos suportam dois modos de saída:

• Legível por humanos (padrão): Tabelas, cores, texto formatado
• Legível por máquina (flag --json): JSON estruturado para consumo por agentes

# Saída humana
cli-anything-chromadb server heartbeat

# Saída JSON para agentes
cli-anything-chromadb --json server heartbeat

Para Agentes de IA

Ao usar esta CLI programaticamente:

1. Sempre use a flag --json para saída parseável
2. Verifique os códigos de retorno - 0 para sucesso, diferente de zero para erros
3. Analise o stderr para mensagens de erro em caso de falha
4. Use --host para conectar a instâncias ChromaDB não padrão

Versão

1.0.0