Installation

Prefer to watch? Here's the 4-minute install walkthrough; the written steps are below.

Prerequisites

Rhino 7 or 8 on Windows (the plugin targets net48 and is built against the Rhino 7 SDK, so one .gha loads in both).
For live control: nothing extra to install, the bridge (egret-bridge.exe) ships with the plugin and Connect auto-starts it. Your PC just needs network access to the robot.

Install the .gha

Close Rhino fully (save any work first).
Copy Egret.gha into your Grasshopper Libraries folder:
```
%AppData%\Grasshopper\Libraries\Egret\Egret.gha
```
Create the Egret subfolder if it doesn't exist.
If your browser flagged the .gha as "from internet", right-click it → Properties → Unblock.
Open Rhino, then Grasshopper. You should see an Egret tab in the GH ribbon.

Verify the install

Drop a Info component on the canvas (→ Utilities).
Wire its Version output to a Panel.
You should see the current version string (something like 0.61.0).
The Assembly Path output shows which .gha actually loaded, useful if you suspect a stale copy is lingering.

Common mistake: if you re-copy the .gha while Rhino is open, Windows holds a file lock and the copy silently fails or partially completes. Always close Rhino first. The post-build copy in this repo's csproj is ContinueOnError=true so dev builds don't bomb, but you'll still need to restart Rhino to pick up a new build.

Live control (digital twin / live send / drag mode / record)

No separate install, the bridge ships inside the plugin folder as egret-bridge.exe. To go live:

Drop a Connect component (→ Live).
Set Robot IP to your arm's address (see it in uFactory Studio); leave Host at 127.0.0.1 and Auto-start on.
Toggle Enable. Connect launches the bridge for you (read-only at first) and connects, no terminal, no Python.
When you're ready to move the arm, flip Allow Motion on.

Continue to Hello World.