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`
- License 许可
- MIT
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- vector-setup
- description
- First-run setup for ruvector@0.2.25 — installs ONNX/Brain/SONA add-ons, registers the MCP server, and verifies the install via `doctor`
- allowed-tools
- Bash Read
- argument-hint
- [--full]
03 SKILL.md 正文
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:
| Error | Missing 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
- Pin ruvector:
npm install ruvector@0.2.25 - Install the add-ons (idempotent — only what's missing):
For a leaner install, passnpm install ruvector-onnx-embeddings-wasm \ @ruvector/pi-brain \ @ruvector/ruvllm--fullto also pull@ruvector/graph-nodeand@ruvector/router:npm install ruvector-onnx-embeddings-wasm \ @ruvector/pi-brain \ @ruvector/ruvllm \ @ruvector/graph-node \ @ruvector/router - Verify the binary:
npx -y ruvector@0.2.25 doctor npx -y ruvector@0.2.25 info - Register the MCP server:
claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start claude mcp list | grep ruvector - Sanity check the most common subcommands:
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 - (Optional) Generate a pi identity for brain + edge:
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/sonanative binding (the JS fallback via@ruvector/ruvllmis 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.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.