How do I install the Setup Ryu skill?

Run npx skillmds@latest add amajorai/setup-ryu-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Setup Ryu safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Setup Ryu?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Setup Ryu free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Setup Ryu?

amajorai (@amajorai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Setup Ryu by amajorai — Agent Skill

Name: Setup Ryu
Author: amajorai

Setup Ryu

Get the user's Ryu Core node running and serving a local model so this plugin's ryu_* tools work. Covers what Ryu is, launching Core or the desktop app, verifying health on 127.0.0.1:7980, and activating a local model. The plugin already wires the MCP bridge, so this skips manual MCP config. Use when ryu_health fails or the user asks to install, start, or connect to Ryu.

amajorai Updated Sep 21, 2026

File contents

Set up Ryu (plugin edition)

This plugin already wires the Ryu MCP bridge into Claude Code, so you do not configure mcpServers by hand. Your job is to make sure the node this plugin points at is actually running and serving a model. Work top to bottom and do not skip the health check.

What Ryu is

Ryu is a local-first AI node on the user's own machine. Two pieces matter here:

Core - the brain and HTTP API on http://127.0.0.1:7980. Owns the model catalog, agents, workflows, RAG Spaces, MCP registry, and chat. Every ryu_* tool in this plugin talks to Core.
Gateway - the OpenAI-compatible inference gateway on http://127.0.0.1:7981. Serves the active local model and meters usage.

The desktop app boots both. A headless user can run just Core.

Step 1 - make sure Core is up

Desktop: have the user install and open the Ryu desktop app. It starts Core and Gateway automatically.
Headless from the repo: Core is a Rust binary under apps/core; run it with the project's standard run command. It binds :7980.

The plugin's Core URL is set from the ryu_core_url plugin option (default http://127.0.0.1:7980). If the node needs auth, set ryu_core_token.

Step 2 - verify health (do not skip)

Call the ryu_health tool. A healthy node returns {"status":"ok"}. If it errors, Core is not reachable: recheck Step 1 and confirm the ryu_core_url option matches where Core is actually listening. Then call ryu_system_status for engine and sidecar state.

Step 3 - activate a local model

If ryu_get_active_model shows nothing serving, help the user pick one:

ryu_search_models with a query (for example qwen3) to browse the catalog.
Install a specific GGUF from the Ryu desktop model store, or via the models REST surface (see the ryu-local-model skill).
ryu_set_active_model with the installed model id, then ryu_get_active_model to confirm.

Step 4 - confirm the loop

Call ryu_health, then ryu_get_active_model. If both succeed, the plugin is fully wired to a live node and every other ryu_* tool and /ryu:* command will work.

Where to go next

Full tool reference and driving patterns: [[ryu-tools]]
Search, download, and serve local models in depth: [[ryu-local-model]]

---name: setup-ryu-3description: Get the user's Ryu Core node running and serving a local model so this plugin's ryu_* tools work. Covers what Ryu is, launching Core or the desktop app, verifying health on 127.0.0.1:7980, and activating a local model. The plugin already wires the MCP bridge, so this skips manual MCP config. Use when ryu_health fails or the user asks to install, start, or connect to Ryu.---# Set up Ryu (plugin edition)This plugin already wires the Ryu MCP bridge into Claude Code, so you do not configure `mcpServers` by hand. Your job is to make sure the node this plugin points at is actually running and serving a model. Work top to bottom and do not skip the health check.## What Ryu isRyu is a local-first AI node on the user's own machine. Two pieces matter here:- Core - the brain and HTTP API on `http://127.0.0.1:7980`. Owns the model catalog, agents, workflows, RAG Spaces, MCP registry, and chat. Every `ryu_*` tool in this plugin talks to Core.- Gateway - the OpenAI-compatible inference gateway on `http://127.0.0.1:7981`. Serves the active local model and meters usage.The desktop app boots both. A headless user can run just Core.## Step 1 - make sure Core is up- Desktop: have the user install and open the Ryu desktop app. It starts Core and Gateway automatically.- Headless from the repo: Core is a Rust binary under `apps/core`; run it with the project's standard run command. It binds `:7980`.The plugin's Core URL is set from the `ryu_core_url` plugin option (default `http://127.0.0.1:7980`). If the node needs auth, set `ryu_core_token`.## Step 2 - verify health (do not skip)Call the `ryu_health` tool. A healthy node returns `{"status":"ok"}`. If it errors, Core is not reachable: recheck Step 1 and confirm the `ryu_core_url` option matches where Core is actually listening. Then call `ryu_system_status` for engine and sidecar state.## Step 3 - activate a local modelIf `ryu_get_active_model` shows nothing serving, help the user pick one:1. `ryu_search_models` with a query (for example `qwen3`) to browse the catalog.2. Install a specific GGUF from the Ryu desktop model store, or via the models REST surface (see the `ryu-local-model` skill).3. `ryu_set_active_model` with the installed model id, then `ryu_get_active_model` to confirm.## Step 4 - confirm the loopCall `ryu_health`, then `ryu_get_active_model`. If both succeed, the plugin is fully wired to a live node and every other `ryu_*` tool and `/ryu:*` command will work.## Where to go next- Full tool reference and driving patterns: [[ryu-tools]]- Search, download, and serve local models in depth: [[ryu-local-model]]

Frequently asked questions