Que fait cli-anything-chromadb ?
Interface en ligne de commande sans état pour la base de données vectorielles ChromaDB, basée sur l'API HTTP v2. Conçue pour les agents IA et les utilisateurs avancés qui ont besoin de gérer des collections, des documents et d'exécuter des requêtes sémantiques sans interface navigateur.
Installation
Cette CLI est installée via le paquet cli-anything-chromadb :
pip install cli-anything-chromadb
Prérequis :
- Python 3.10+
- Serveur ChromaDB en cours d'exécution sur localhost:8000 (ou spécifiez via --host)
Utilisation
Commandes de base
# Afficher l'aide
cli-anything-chromadb --help
# Démarrer le mode interactif REPL
cli-anything-chromadb
# Vérifier la santé du serveur
cli-anything-chromadb --json server heartbeat
# Lister toutes les collections
cli-anything-chromadb --json collection list
# Recherche sémantique
cli-anything-chromadb --json query search --collection hub_knowledge --text "Comment déployer"
Mode REPL
Lorsqu'il est invoqué sans sous-commande, le CLI entre dans une session interactive REPL :
cli-anything-chromadb
# Saisissez les commandes de manière interactive avec complétion par tabulation et historique
Groupes de commandes
server
Commandes de santé et de version du serveur.
| Commande | Description |
|---|---|
heartbeat | Vérifier la santé du serveur ChromaDB |
version | Obtenir la version du serveur ChromaDB |
collection
Gérer les collections ChromaDB.
| Commande | Description |
|---|---|
list | Lister toutes les collections |
create --name NOM | Créer une nouvelle collection |
delete --name NOM | Supprimer une collection |
info NOM | Obtenir les informations d'une collection |
document
Gérer les documents dans les collections.
| Commande | Description |
|---|---|
add --collection C --id ID --document TEXTE | Ajouter un ou des documents |
get --collection C | Obtenir des documents |
delete --collection C --id ID | Supprimer un ou des documents |
count --collection C | Compter les documents |
query
Recherche sémantique dans les collections.
| Commande | Description |
|---|---|
search --collection C --text T | Recherche sémantique |
Formats de sortie
Toutes les commandes prennent en charge deux modes de sortie :
- Lisible par l'humain (par défaut) : tableaux, couleurs, texte formaté
- Lisible par la machine (flag
--json) : JSON structuré pour consommation par un agent
# Sortie humaine
cli-anything-chromadb server heartbeat
# Sortie JSON pour les agents
cli-anything-chromadb --json server heartbeat
Pour les agents IA
Lorsque vous utilisez cette CLI de manière programmatique :
- Utilisez toujours le flag
--jsonpour une sortie analysable - Vérifiez les codes de retour - 0 pour succès, non nul pour erreurs
- Analysez stderr pour les messages d'erreur en cas d'échec
- Utilisez
--hostpour vous connecter à des instances ChromaDB non par défaut
Version
1.0.0