skills.rest
ruvnet
ruvnetCOMMUNITY
Explore all skills by this author →
Website𝕏@ruvGitHub

vector-setup

Installs ruvector add-ons, registers the MCP server, and verifies the setup via doctor.

70.1k|8.4k|Updated Jun 2, 2025
Search Tags:#doctor#RuVector#ONNX embeddings#npm install#CLI verification#Setup#MCP Server
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill vector-setup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vector-setup
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-ruvector/skills/vector-setup
Command: npx skills add https://github.com/ruvnet/claude-flow --skill vector-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruvector, ruvector-onnx-embeddings-wasm, @ruvector/pi-brain, @ruvector/ruvllm.

What problem does it solve?

Out of the box, several ruvector subcommands fail with confusing dependency errors such as missing ONNX WASM files, @ruvector/pi-brain, or @ruvector/ruvllm. This Skill performs the first-run setup so every /vector subcommand works immediately.

Core Features & Use Cases

  • Dependency Installation: Pins [email protected] and installs the ONNX embeddings, pi-brain, and ruvllm add-ons in one idempotent pass, with an optional --full flag for graph-node and router.
  • MCP Server Registration: Registers ruvector as an MCP server with Claude and confirms it appears in the server list.
  • Verification & Smoke Testing: Runs doctor, info, and common subcommands (hooks route, attention list, rvf examples) plus a bundled smoke script to detect drift from the contracted CLI surface.
  • Use Case: After installing the ruflo-ruvector plugin, run this Skill once so commands like hooks route and attention list stop failing with module-not-found errors.

Quick Start

Ask the assistant to run the vector-setup skill to install ruvector and its add-ons, register the MCP server, and verify everything with doctor.

Frequently Asked Questions about vector-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up ruvector for the first time?▼

Install [email protected] via npm, then add ruvector-onnx-embeddings-wasm, @ruvector/pi-brain, and @ruvector/ruvllm. Verify with npx ruvector doctor and register the MCP server using claude mcp add.

How do I fix the ONNX WASM files not bundled error in ruvector?▼

This error means the ruvector-onnx-embeddings-wasm package is missing. Install it with npm alongside ruvector, then rerun npx ruvector doctor to confirm the onnx directory is detected.

How do I register ruvector as an MCP server in Claude?▼

Run claude mcp add ruvector -- npx -y [email protected] mcp start, then confirm registration with claude mcp list. The server should appear in the output.

Why does ruvector say SONA is not available?▼

SONA fails when its native module cannot load. Installing @ruvector/ruvllm provides a JavaScript fallback that works on macOS arm64, while Linux x64 uses its own native binding.

What does the ruvector smoke test check?▼

The bundled smoke.sh script verifies the version pin, top-level subcommand visibility, hooks ast-analyze, hooks route, attention list, rvf examples, and info. It exits non-zero if any output drifts from the expected CLI surface.

Related Skills

Explore More Software Engineering Skills→
IvanMurzakIvanMurzak
3.8k

build-cli

Builds the unity-mcp-cli TypeScript tool and links it globally.

Community
Intermediate
KingInYellowsKingInYellows

ruvector-conventions

Define MCP schema and naming conventions for ruvector vector memory workflows.

Official
Intermediate
vut08905vut08905

openclaw-parallels-smoke

Execute cross-platform smoke tests for OpenClaw on Parallels VM guests.

Community
Intermediate
vercelvercel
142.0k

next-rspack

Maintain and upgrade @next/rspack-core and @next/rspack-binding packages.

Official
Intermediate