← ClaudeAtlas

setup-ryulisted

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/ryu · ★ 42 · AI & Automation · score 73
Install: claude install-skill amajorai/ryu
# Set up Ryu (plugin edition) This plugin already wires the Ryu MCP bridge into Codex, so you do not configure MCP servers by hand. Your job is to make sure the node this plugin points at is 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 bridge reads its target from `RYU_CORE_URL` (default `http://127.0.0.1:7980`) in the plugin's `.mcp.json`. Set `RYU_CORE_TOKEN` there if the node requires auth. ## 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 `RYU_CORE_URL` matches where Core is actually listening. Then call `ryu_system_status` for engine and sidecar state. ## Step 3 - act