WARUDO Agent Bridge

English | 한국어 | 日本語

Ask an AI in plain words, and it operates WARUDO for you.

Send a chat message like "Smile, wave, and take one shot from the front." The AI moves the camera in WARUDO, changes the expression, sets the pose, takes the photo and shows it to you. No coding needed. Installing means pasting one command.

<p> <img src="docs/images/photo-full.jpg" width="24%" alt="full body front shot"> <img src="docs/images/face-wink.jpg" width="24%" alt="wink expression"> <img src="docs/images/pose-wave.jpg" width="24%" alt="hand wave pose"> <img src="docs/images/pose-kneel.jpg" width="24%" alt="kneeling pose"> </p>

_{The photos above are all real screenshots of the WARUDO default character (Shipilka) running the requests from the examples section through this bridge.}

Not affiliated with WARUDO or HakuyaLabs. Free (MIT licensed), made by StudioRaming.

Table of contents

1. What is MCP? (start here if new)
2. What can you do? (examples)
3. Requirements
4. Install (step by step)
5. Connect to an AI app: Claude Desktop, Claude Code, Codex, ChatGPT Desktop
6. First use
7. Safe use
8. FAQ
9. Troubleshooting
10. Advanced

What is MCP?

ChatGPT and Claude can normally only chat in text. They cannot click buttons in a program running on your computer.

MCP (Model Context Protocol) is a common spec for giving tools to AI. Think of USB. The spec is the same everywhere, so it plugs into any AI app.

WARUDO Agent Bridge is a set of MCP tools for WARUDO. Once installed, the AI gets 86 tools: "move camera", "change expression", "set pose", "take photo" and more.

you (ask in chat)
 ↓
AI app (Claude, Codex, ChatGPT Desktop)
 ↓ MCP
WARUDO Agent Bridge (runs on your PC)
 ↓
WARUDO

Good to know:

• AI app and WARUDO must be running on the same PC. The bridge passes data to WARUDO only through files on your PC. It opens no internet port.
• Chat goes to the AI service. What you send and what the AI reads (scene info, captured photos) are handled by that company's servers like normal chat.
• The bridge is free. AI app fees follow each service's pricing.
• Windows only. WARUDO is a Windows program.

What can you do?

Examples of what you send to AI and the result. For each photo, the tools that fit the request were actually run through this bridge on the WARUDO default character (Shipilka). AI replies are shortened. "Tools used" are chosen by AI; you don't need to memorize them.

📸 Photos and camera

| 💬 You ask | 🤖 Result | | --- | --- | | "Take a full-body shot from the front." | <img src="docs/images/photo-full.jpg" width="260" alt="full body front"><br>"Moved the camera to the front of the character and took a shot."<br>_{Tools: warudo_camera_pose → warudo_camera_capture} | | "Take a close-up of the face." | <img src="docs/images/photo-face.jpg" width="260" alt="face close-up"><br>"Read the head bone position and put the camera close to the face."<br>_{Tools: warudo_character_pose_get → warudo_camera_pose → warudo_camera_capture} | | "Take a striking low-angle shot." | <img src="docs/images/photo-low.jpg" width="260" alt="low angle"><br>"Shot from knee height, looking up at an angle."<br>_{Tools: warudo_camera_pose → warudo_camera_capture} |

"Take a photo from front, diagonal, side and back. Show me all four."

<img src="docs/images/camera-turnaround.jpg" width="720" alt="four angle shots">

"Widened the field of view to 60 degrees and walked around the character taking four shots."<br> _{Tools: warudo_camera_zoom → warudo_camera_pose → warudo_camera_capture (four times; shown as one composite here)}

😊 Expressions

Each character has different expression names. The AI reads the character's expression list (blendshapes) first, then picks the ones that fit your request. This character had 106.

| 💬 You ask | 🤖 Result | | --- | --- | | "Make her smile big." | <img src="docs/images/face-smile.jpg" width="260" alt="smiling expression"><br>"Turned on smiling eyes (笑い), happy eyes (にこり), mouth corners (口角上げ), open mouth (あ), and rosy cheeks (照れ)."<br>_{Tools: warudo_character_blendshapes → warudo_character_blendshape} | | "Wink and stick your tongue out a bit." | <img src="docs/images/face-wink.jpg" width="260" alt="wink expression"><br>"Turned on wink (ウィンク) and tongue out (てへぺろ)."<br>_{Tools: warudo_character_blendshape} | | "Surprised face!" | <img src="docs/images/face-surprised.jpg" width="260" alt="surprised expression"><br>"Turned on surprised eyes (びっくり), surprised mouth (口_驚き), and raised eyebrows (上)."<br>_{Tools: warudo_character_blendshape} | | "Reset the expression." | "Cleared all the expressions I changed. Back to the default."<br>_{Tools: warudo_character_blendshape (clear)} |

🙋 Poses

Poses work by saying which way to aim body parts. The bridge prevents impossible joint angles, and returns the result once the pose actually shows on screen.

| 💬 You ask | 🤖 Result | | --- | --- | | "Make a hand-wave pose." | <img src="docs/images/pose-wave.jpg" width="260" alt="hand wave"><br>"Right arm up to the side, elbow bent. Tilted the head a bit."<br>_{Tools: warudo_character_pose_set} | | "Do a banzai pose!" | <img src="docs/images/pose-banzai.jpg" width="260" alt="banzai"><br>"Both arms stretched straight up. Lifted the head a bit."<br>_{Tools: warudo_character_pose_set} | | "Hands on hips, confident stance." | <img src="docs/images/pose-hips.jpg" width="260" alt="hands on hips"><br>"Elbows out, hands on hips. Chest out, chin up a bit."<br>_{Tools: warudo_character_pose_set} | | "Kneel and clasp your hands together." | <img src="docs/images/pose-kneel.jpg" width="260" alt="kneeling"><br>"Lowered hips to 33.5cm above ground. Shins on the floor. Hands together in front."<br>_{Tools: warudo_character_pose_set (hipsHeight)} |

"Check if the pose is right. Is the foot sinking into the floor?"

<img src="docs/images/analysis-kneel.jpg" width="640" alt="analysis render: skeleton from front and side">

"Drew the skeleton without clothes and background from front and side. Knees and feet touch the floor. The shoe tips sink about 0.5cm. The tail ornament reaches 18cm below the floor, so in this sitting pose it will look buried."<br> _{Tools: warudo_analysis_capture (WARUDO screen does not change)}

| 💬 You ask | 🤖 Result | | --- | --- | | "Save this pose as a .anim file for Unity." | "Kneel_Readme.anim (70KB) saved. You can use it as a humanoid animation in a Unity project."<br>_{Tools: warudo_character_pose_save} | | "Release the pose and return to the default idle." | "Released the pose and switched back to the default idle animation (AGIA_Idle_generic_01)."<br>_{Tools: warudo_character_pose_clear} |

💃 Animations and outfits

| 💬 You ask | 🤖 Result | | --- | --- | | "Dance happily." | <img src="docs/images/anim-dance.jpg" width="260" alt="dancing"><br>"Set the default WARUDO dance 'High Rhythm Dance 01' as the idle animation."<br>_{Tools: warudo_resource_list → warudo_character_animation} | | "Take off the hat and wings." | <img src="docs/images/outfit-off.jpg" width="260" alt="hat and wings removed"><br>"Found the hat (HeadItem_Hat, HeadItem_Halo) and wings (Item_Wing, Item_SmallWing) objects in the character and turned them off."<br>_{Tools: warudo_hierarchy_list → warudo_object_active} |

🔎 Scene inspection and undo

| 💬 You ask | 🤖 Result | | --- | --- | | "Is the bridge connected?" | "Yes. Version 0.2.0 is running inside WARUDO, and I checked the open scene name."<br>_{Tools: warudo_status} | | "What's in the scene?" | "One camera, an environment, a directional light, one character (Shipilka), an FPS counter, and a beginner setup helper."<br>_{Tools: warudo_scene_get} | | "What blueprints are there?" | "Two blueprints named 'New Blueprint' are on, and both are empty (no nodes)."<br>_{Tools: warudo_blueprint_list} | | "I'm going to experiment, so save the current state first." | "Made a recovery snapshot. Did not touch the scene file. Tell me if you want to undo."<br>_{Tools: warudo_scene_snapshot (undo with warudo_scene_restore)} |

💡 More requests like these

| Request | Tools AI uses | | --- | --- | | "Move the character 1 meter to the right and turn her to face the camera." | warudo_asset_transform | | "Change the light to orange like sunset and make it a bit brighter." | warudo_asset_fields → warudo_asset_patch | | "Switch to a different background. Show me what's available first." | warudo_resource_list → warudo_asset_source → warudo_asset_wait_loaded | | "Play the hand-wave animation once." | warudo_character_animation (oneShot) | | "Stretch the right hand toward this prop so it touches." | warudo_character_ik_set | | "Pose like this photo." (attach photo) | warudo_analysis_capture → warudo_character_pose_set (repeat) | | "Turn off all clothes and show just the body. Put them back when done." | warudo_hierarchy_list → warudo_object_active | | "Take a full WARUDO screen capture with the UI." | warudo_screen_capture | | "It looks like there was an error. Check the WARUDO log and find the cause." | warudo_runtime_logs | | "Save the current scene as 'stream_test'." | warudo_scene_save_as | | "Show the scene list and open the one I used yesterday." | warudo_scene_list → warudo_scene_open | | "Change this node value in the blueprint." | warudo_blueprint_get → warudo_node_patch | | "Click the Apply button in WARUDO's panel while I keep working in another window." | warudo_ui_list → warudo_ui_click |

All 86 tools are in docs/TOOLS.md.

Tips for good requests

• If you want to see the result, add "and show me a photo" at the end. The AI takes a photo and shows it in the chat.
• If you don't like it, just ask to adjust. "Raise the arm a bit higher", "move the camera a bit left".
• You can make multiple requests at once. "Smile, wave your hand, and take a photo from the front."
• When done, "put it back to normal" resets the expression, pose and camera in one request.

Requirements

| What | Notes | | --- | --- | | Windows 10 or 11 PC | | | WARUDO (Steam) | No mod install needed. The bridge runs as a WARUDO Playground script. | | One AI app | Claude Desktop, Claude Code, Codex, ChatGPT Desktop, or Cursor. See Connect to an AI app. | | Node.js 20 or newer | You don't need to know what this is. If it is missing, the installer offers to install it. |

Install the AI app and run it once first, then install the bridge. The installer finds AI apps on this PC and connects automatically.

Install

Step 1: Open PowerShell

• Windows 11: Right-click the Start button (Windows logo) at the bottom → Terminal
• Windows 10: Right-click the Start button → Windows PowerShell

A black (or blue) window appears. No admin access needed.

Step 2: Paste the install command

Copy the line below, paste it into the PowerShell window (Ctrl+V or right-click), and press Enter.

irm https://raw.githubusercontent.com/StudioRaming/warudo-agent-bridge/main/install.ps1 | iex

This downloads and runs install.ps1 from this repo. Open the link first if you want to see what it does.

Step 3: Answer questions if they appear

If Node.js is missing, it asks:

Install Node.js LTS now with winget? [Y/n]

Type Y and press Enter. Windows asks "Do