LLMSkillHub
mirroredCopied from ruvnet/ruflo under MIT. ruvnet has not claimed this page, and is not affiliated with LLM SkillHub.

ruvnet / vector-setup

First-run setup for ruvector@0.2.25 — installs ONNX/Brain/SONA add-ons, registers the MCP server, and verifies the install via `doctor`

0
SKILL.md
2.8 KB

Vector Setup

Bootstraps ruvector@0.2.25 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:
    `bash
    npm install ruvector@0.2.25
    `

  2. Install the add-ons (idempotent — only what's missing):
    `bash
    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:
    `bash
    npm install ruvector-onnx-embeddings-wasm \
    @ruvector/pi-brain \
    @ruvector/ruvllm \
    @ruvector/graph-node \
    @ruvector/router
    `

  3. Verify the binary:
    `bash
    npx -y ruvector@0.2.25 doctor
    npx -y ruvector@0.2.25 info
    `

  4. Register the MCP server:
    `bash
    claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
    claude mcp list | grep ruvector
    `

  5. Sanity check the most common subcommands:
    `bash
    npx -y ruvector@0.2.25 hooks route "test"
    npx -y ruvector@0.2.25 attention list
    npx -y ruvector@0.2.25 rvf examples
    `

  6. (Optional) Generate a pi identity for brain + edge:
    `bash
    npx -y ruvector@0.2.25 identity generate
    npx -y ruvector@0.2.25 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.