# Vector Setup > Configuración inicial de ruvector@0.2.25: instala los complementos ONNX/Brain/SONA, registra el servidor MCP y verifica la instalación con `doctor`. Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/vector-setup Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/vector-setup.md Repositorio: https://github.com/ruvnet/ruflo Autor: ruvnet Licencia: MIT Actualizado: hace 3 meses Coste de contexto: 34 tok instalada, 722 tok al activarse, 722 tok con todos los archivos del bundle Bundle: 1 archivo, 3 KB Permisos que pide: bash read ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add ruvnet/ruflo --skill vector-setup --agent claude-code # Cursor npx -y skills add ruvnet/ruflo --skill vector-setup --agent cursor # Codex npx -y skills add ruvnet/ruflo --skill vector-setup --agent codex # Gemini CLI npx -y skills add ruvnet/ruflo --skill vector-setup --agent gemini # Windsurf npx -y skills add ruvnet/ruflo --skill vector-setup --agent windsurf # Cline npx -y skills add ruvnet/ruflo --skill vector-setup --agent cline ``` ## Qué hace - Instala ruvector@0.2.25 junto con sus complementos opcionales (ONNX, pi-brain, ruvllm, graph-node, router) - Verifica el binario con `doctor` e `info` y registra el servidor MCP - Genera opcionalmente una identidad pi para brain y edge - Ejecuta un script de smoke test que confirma que los subcomandos principales funcionan ## Cuándo usarla - Los subcomandos /vector fallan con errores de dependencias como 'ONNX WASM files not bundled' o 'SONA not available' - Es la primera vez que configuras ruvector en el proyecto ## Qué la activa - "Configura ruvector desde cero en este proyecto" - "Mis comandos /vector fallan, ayúdame a instalarlos bien" ## Antes de instalar - Requiere Node y npm; no instala el toolchain nativo de Rust ni bindings nativos específicos de plataforma. ## Archivos - SKILL.md — 3 KB ## SKILL.md Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés. # 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**: ```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 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. ## Dónde encaja - Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código. - Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución. - [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde. - [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento. - [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP. - [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)