Tiny unofficial ChromaDB operations CLI
Project description
ChromaDB Operations Tools
Tiny collection of utilities to help you managed ChromaDB indices.
WARNING: These tools rely on internal ChromaDB APIs and may break in the future.
☠️☠️☠️ BEFORE YOU BEGIN ☠️☠️☠️
Before you use these tools make sure your ChromaDB persistent dir, on which you intend to run these tools, is backed up.
Installation
pip install chromadb-ops
Usage
WAL Commit
This command ensures your WAL is committed to binary vector index (HNSW).
chown commit-wal /path/to/persist_dir
WAL Cleanup
This command cleans up the committed portion of the WAL and VACUUMs the database.
chown cleanup-wal /path/to/persist_dir
WAL Export
This commands exports the WAL to a jsonl
file. The command can be useful in taking backups of the WAL.
chown export-wal /path/to/persist_dir --out /path/to/export.jsonl
Note: If --out or -o is not specified the command will print the output to stdout.
Using Docker
Note: You have to mount your persist directory into the container for the commands to work.
Building the image:
docker build -t chops .
WAL Commit
docker run -it --rm -v ./persist_dir:/chroma-data chops commit-wal /chroma-data
WAL Cleanup
docker run -it --rm -v ./persist_dir:/chroma-data chops clean-wal /chroma-data
WAL Export
docker run -it --rm -v ./persist_dir:/chroma-data -v ./backup:/backup chops export-wal /chroma-data --out /backup/export.jsonl
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for chromadb_ops-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bf3c6abd50d64182736245146110d7c290e0d7ad4bf41413076a899f36f11398 |
|
MD5 | 18cc8c575255dc15af4d2f82320dd8a2 |
|
BLAKE2b-256 | f682bab3914dabe0515ee666a18e41e8257d9d39b0e8da92fd9f8db61ad068c1 |