Skip to content

docs: start ChromaDB via the bundled npm CLI, drop redundant Python install#1

Open
malixsys wants to merge 1 commit into
glatinone:masterfrom
malixsys:docs/easier-chroma-on-mac
Open

docs: start ChromaDB via the bundled npm CLI, drop redundant Python install#1
malixsys wants to merge 1 commit into
glatinone:masterfrom
malixsys:docs/easier-chroma-on-mac

Conversation

@malixsys

Copy link
Copy Markdown

What

Starting ChromaDB no longer needs Python. mcp-server already depends on the npm chromadb package, which ships the native chroma server CLI (with prebuilt macOS and Linux bindings). This adds a root chroma script that runs the already-installed copy and points the docs at it.

Why

The README and setup.js told users to pip install chromadb && chroma run --path ./storage/chroma. That is redundant, the server binary is already installed via npm, and it is fragile on macOS, where a stale or broken Python/pyenv setup makes pip and chroma fail before anything runs. The npm route needs no Python and no second download.

Changes

  • package.json: add "chroma": "node mcp-server/node_modules/chromadb/dist/cli.mjs run --path ./storage/chroma".
  • README.md: drop the Python 3.10+ prerequisite and the pip install block; document npm run chroma.
  • scripts/setup.js: the printed hints now point at npm run chroma.

How to test

npm run setup     # installs deps (existing step)
npm run chroma    # starts the local ChromaDB server
curl http://localhost:8000/api/v2/heartbeat   # returns a heartbeat

Data persists to ./storage/chroma. Without the server, BraveMCP falls back to SQLite keyword search.

…edundant Python install

The mcp-server already depends on the npm chromadb package, which ships the
native chroma server CLI. Add a root 'chroma' script that runs that installed
copy, and point the README and setup.js at 'npm run chroma' instead of
'pip install chromadb && chroma run', so no Python or extra download is needed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant