Was macht cli-anything-chromadb?
Eine zustandslose Befehlszeilenschnittstelle für die ChromaDB-Vektordatenbank, basierend auf der HTTP-API v2. Entwickelt für KI-Agenten und Power-User, die Sammlungen und Dokumente verwalten und semantische Abfragen ohne Browser-UI durchführen müssen.
Installation
Diese CLI wird als Teil des Pakets cli-anything-chromadb installiert:
pip install cli-anything-chromadb
Voraussetzungen:
- Python 3.10+
- ChromaDB-Server, der unter localhost:8000 läuft (oder über
--hostangeben)
Verwendung
Grundlegende Befehle
# Hilfe anzeigen
cli-anything-chromadb --help
# Interaktiven REPL-Modus starten
cli-anything-chromadb
# Server-Health überprüfen
cli-anything-chromadb --json server heartbeat
# Alle Sammlungen auflisten
cli-anything-chromadb --json collection list
# Semantische Suche
cli-anything-chromadb --json query search --collection hub_knowledge --text "Wie deploye ich"
REPL-Modus
Wenn ohne Unterbefehl aufgerufen, startet die CLI eine interaktive REPL-Sitzung:
cli-anything-chromadb
# Befehle interaktiv mit Tab-Vervollständigung und Verlauf eingeben
Befehlgruppen
server
Befehle für Server-Health und Version.
| Befehl | Beschreibung |
|---|---|
heartbeat | Health des ChromaDB-Servers prüfen |
version | Version des ChromaDB-Servers abrufen |
collection
ChromaDB-Sammlungen verwalten.
| Befehl | Beschreibung |
|---|---|
list | Alle Sammlungen auflisten |
create --name NAME | Neue Sammlung erstellen |
delete --name NAME | Sammlung löschen |
info NAME | Informationen zu einer Sammlung abrufen |
document
Dokumente in Sammlungen verwalten.
| Befehl | Beschreibung |
|---|---|
add --collection C --id ID --document TEXT | Dokument(e) hinzufügen |
get --collection C | Dokumente abrufen |
delete --collection C --id ID | Dokument(e) löschen |
count --collection C | Dokumente zählen |
query
Semantische Suche in Sammlungen.
| Befehl | Beschreibung |
|---|---|
search --collection C --text T | Semantische Suche |
Ausgabeformate
Alle Befehle unterstützen zwei Ausgabemodi:
- Menschenlesbar (Standard): Tabellen, Farben, formatierter Text
- Maschinenlesbar (
--json-Flag): Strukturiertes JSON für Agenten
# Menschliche Ausgabe
cli-anything-chromadb server heartbeat
# JSON-Ausgabe für Agenten
cli-anything-chromadb --json server heartbeat
Für KI-Agenten
Bei programmatischer Verwendung dieser CLI:
- Verwenden Sie immer das
--json-Flag für interpretierbare Ausgaben - Prüfen Sie die Rückgabecodes – 0 für Erfolg, ungleich 0 für Fehler
- Parsen Sie stderr für Fehlermeldungen bei Misserfolgen
- Verwenden Sie
--hostfür Verbindungen zu nicht standardmäßigen ChromaDB-Instanzen
Version
1.0.0