Vector Setup
- 594 installs
- 67k repo stars
- Updated August 4, 2026
- ruvnet/ruflo
vector-setup is a ruflo Claude Code skill that performs first-run setup for ruvector@0.2.25, installing ONNX, Brain, and SONA add-ons, registering the MCP server, and verifying via doctor.
About
vector-setup is an AI & Agent Building skill in ruvnet/ruflo that bootstraps ruvector@0.2.25 and optional add-ons so every /vector subcommand works on first run. Out of the box, several vector commands fail with missing dependency errors for ruvector-onnx-embeddings-wasm, @ruvector/pi-brain, and SONA packages. The skill installs ONNX WASM embeddings, Brain commands, and SONA components, registers the MCP server, and verifies the install through a doctor check. Developers reach for vector-setup when setting up ruflo vector search on a new machine or after encountering confusing dep errors on /vector subcommands, using the optional --full flag for complete add-on installation.
- vector-setup
Vector Setup by the numbers
- 594 all-time installs (skills.sh)
- +6 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #669 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill vector-setupAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 594 |
|---|---|
| repo stars | ★ 67k |
| Last updated | August 4, 2026 |
| Repository | ruvnet/ruflo ↗ |
How do you set up ruvector for first run?
Use vector-setup for development tasks
Who is it for?
Developers onboarding ruflo vector search who hit missing ONNX, Brain, or SONA dependency errors on /vector subcommands.
Skip if: Projects already running a verified ruvector install with all add-ons and a passing doctor check.
When should I use this skill?
User sets up ruvector, hits ONNX or Brain dependency errors, or needs first-run /vector subcommand bootstrap with --full.
What you get
Installed ruvector@0.2.25 add-ons, registered MCP server, and passing doctor verification
- Installed ruvector add-ons
- Registered MCP server
- Doctor verification pass
By the numbers
- Targets ruvector@0.2.25
- Installs ONNX WASM, Brain, and SONA add-ons
Files
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
1. Pin ruvector:
npm install ruvector@0.2.252. Install the add-ons (idempotent — only what's missing):
npm install ruvector-onnx-embeddings-wasm \
@ruvector/pi-brain \
@ruvector/ruvllmFor 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/router3. Verify the binary:
npx -y ruvector@0.2.25 doctor
npx -y ruvector@0.2.25 info4. Register the MCP server:
claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
claude mcp list | grep ruvector5. 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 examples6. (Optional) Generate a pi identity for brain + edge:
npx -y ruvector@0.2.25 identity generate
npx -y ruvector@0.2.25 identity showSmoke test
For a deterministic verification of the install, run the plugin's bundled smoke script:
bash plugins/ruflo-ruvector/scripts/smoke.shIt 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.
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k
Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198kFAQ
What version does vector-setup install?
vector-setup bootstraps ruvector@0.2.25 and its optional add-ons including ruvector-onnx-embeddings-wasm for ONNX WASM files, @ruvector/pi-brain for Brain commands, and SONA components.
What errors does vector-setup fix?
vector-setup resolves dependency errors such as missing onnx/ WASM directories, Brain commands requiring @ruvector/pi-brain, and unavailable SONA packages that block /vector subcommands on first run.