← ClaudeAtlas

vector-db-launchlisted

Start the Native Python ChromaDB background server. Use when semantic search returns connection refused on port 8110, or when the user wants to enable concurrent agent read/writes.
richfrem/agent-plugins-skills · ★ 3 · AI & Automation · score 62
Install: claude install-skill richfrem/agent-plugins-skills
## Dependencies This skill requires **Python 3.8+** and standard library only. No external packages needed. **To install this skill's dependencies:** ```bash pip-compile ./requirements.in pip install -r ./requirements.txt ``` See `./requirements.txt` for the dependency lockfile (currently empty — standard library only). --- # Vector DB Launch (Python Native Server) ChromaDB provides the vector database backend for semantic search. If configured for Option C (Native Server) in `vector_profiles.json`, the database must be running as a background HTTP service to be accessed by `operations.py`. ## When You Need This - **RAG ingest fails** with connection refused to `127.0.0.1:8110` - **Semantic search** hangs or fails to connect - The user has explicitly selected **Option 2 (Python Native Server)** during `vector-db-init` ## Pre-Flight Check ```bash # Check if ChromaDB is already running curl -sf http://127.0.0.1:8110/api/v1/heartbeat > /dev/null && echo "✅ ChromaDB running" || echo "❌ ChromaDB not running" ``` If it prints "✅ ChromaDB running", you're done. If not, proceed. ## Launching the Server (Native Python) The ChromaDB server runs as a background Python process. It binds to the `${chroma_host}:${chroma_port}` defined in your active profile inside `.agent/learning/vector_profiles.json` (defaults to `127.0.0.1:8110`). Its data volume is mounted from the path defined by the profile's `${chroma_data_path}`. ### Step 1: Start the Service via CLI Instruct the use