mcpField
V
vector-setup

vector-setup

github.com/ruvnetData & databases80.0k683 installsUpdated today
Repository

About vector-setup

vector-setup is a setup skill that installs [email protected] and its add-ons, then checks common commands and MCP registration. It is for users preparing the ruvector CLI for use.

Key features

  1. 01Pins the ruvector version
  2. 02Installs missing add-ons
  3. 03Checks commands with doctor and info
  4. 04Runs a bundled smoke test
  5. 05Optionally generates a pi identity

Use cases

  1. 01Preparing ruvector subcommands for first use
  2. 02Checking an installation after setup
  3. 03Registering the ruvector MCP server
  4. 04Generating a pi identity for brain and edge

MCP support

The skill provides commands to register ruvector as an MCP server with Claude and check that it appears in the server list.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill vector-setup

After installing, type/vector-setupin Claude Code to confirm it loaded.

Details

From the project README

Vector Setup

Bootstraps [email protected] and its optional add-ons so every /vector subcommand actually works on first run.

Why this exists

Out of the box, several /vector subcommands fail with a confusing dep error:

ErrorMissing package
ONNX WASM files not bundled. The onnx/ directory is missing.ruvector-onnx-embeddings-wasm
Brain commands require @ruvector/pi-brain@ruvector/pi-brain
SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js'@ruvector/ruvllm (JS fallback)
LLM commands require @ruvector/ruvllm@ruvector/ruvllm

This skill installs them in one pass.

Steps

  1. Pin ruvector: 
    npm install [email protected]
  2. Install the add-ons (idempotent — only what's missing): 
    npm install ruvector-onnx-embeddings-wasm \
            @ruvector/pi-brain \
            @ruvector/ruvllm
    For a leaner install, pass --full to also pull @ruvector/graph-node and @ruvector/router: 
    npm install ruvector-onnx-embeddings-wasm \
            @ruvector/pi-brain \
            @ruvector/ruvllm \
            @ruvector/graph-node \
            @ruvector/router
  3. Verify the binary: 
    npx -y [email protected] doctor
npx -y [email protected] info
  4. Register the MCP server: 
    claude mcp add ruvector -- npx -y [email protected] mcp start
claude mcp list | grep ruvector
  5. Sanity check the most common subcommands: 
    npx -y [email protected] hooks route "test"
npx -y [email protected] attention list
npx -y [email protected] rvf examples
  6. (Optional) Generate a pi identity for brain + edge: 
    npx -y [email protected] identity generate
npx -y [email protected] identity show

Smoke test

For a deterministic verification of the install, run the plugin's bundled smoke script:

bash plugins/ruflo-ruvector/scripts/smoke.sh

It checks: version pin, top-level subcommand visibility, hooks ast-analyze, hooks route, attention list, rvf examples, and info. Exits non-zero if any drift from the contracted surface is detected.

What this does not install

  • Native Rust toolchain (optional; only needed for source builds)
  • Platform-specific native bindings (auto-detected by @ruvector/core)
  • @ruvector/sona native binding (the JS fallback via @ruvector/ruvllm is sufficient on macOS arm64; Linux x64 has its own native binding)

If doctor still reports a problem after this skill runs, paste its output verbatim and ask.

Comments

Markdown supported