Back to Rhino AI Agent
Installation support

Manual install from a downloaded package

If PackageManager cannot reach the package server — a common situation in mainland China or on an offline workstation — download the package file and install it directly in Rhino 8. It is the same package, installed the same way.

Version 1.1.6 Rhino 8.30+ Windows About 3 minutes
Five steps

Install the package file in Rhino 8

Nothing here replaces PackageManager — you still install through it, just from a local file instead of a search result.

1

Download the package file

Use the button below to download designtoolbox-latest-rh8_30-win.yak. This filename always points at the newest release — currently version 1.1.6 for Rhino 8.30 or later on Windows. The same folder also holds versioned copies named designtoolbox-<version>-rh8_30-win.yak if you need to keep a specific build.

Keep the .yak extension. If your browser saves it as .zip or .txt, rename it back before installing.

2

Run -PackageManager in Rhino 8

Start Rhino 8, type -PackageManager on the command line and press Enter. Mind the leading hyphen - — it runs the scripted, command-line version instead of opening the dialog. When the options Search / Install appear, click Install (or type Install and press Enter).

Running -PackageManager on the Rhino 8 command line and choosing Install from the Search / Install options
3

Pick the .yak file you downloaded

At the Package file ( Browse ): prompt, click Browse to open the file dialog, select the .yak file you downloaded, and Rhino installs it. You can also paste the full path to the .yak file on the command line and press Enter.

Even simpler: drag and drop the downloaded .yak file onto the Rhino window to install it.

The Rhino 8 command line showing the Package file ( Browse ) prompt, ready to select the .yak file
4

Restart Rhino

Close Rhino completely and start it again. The plugin only loads after a restart.

5

Run DesignToolbox and sign in

Type DesignToolbox on the command line and press Enter to open the panel, then sign in inside the panel.

The DesignToolbox agent panel open in Rhino 8 showing the sign-in screen

Prefer the standard route? If your network can reach the package server, simply run PackageManager and search for designtoolbox. See the standard installation steps.

Troubleshooting

Sign-in fails: Rhino is blocked from the network

The panel opens, but signing in fails with a network permission error. This is a local firewall or security-software setting on this computer, not an account or server problem.

1

What you see

The DesignToolbox panel opens normally, but signing in fails. The Rhino command line shows login failed together with An attempt was made to access a socket in a way forbidden by its access permissions — Windows socket error 10013.

2

Why this happens

Something on this computer is blocking the Rhino program itself from reaching the network. The panel's page loads in its own embedded browser process, so it can still open; the sign-in request is sent by Rhino directly, so it gets blocked. This has nothing to do with your account, password or the server. The most common causes are a Windows Firewall outbound rule for Rhino (often named "Rhino 8"), a security suite's program network control (for example Huorong or 360's "block network access"), or a company network policy enforced by device-management software.

3

Confirm the cause

If sign-in works while a VPN or proxy tool is running and fails as soon as you turn it off, this is almost certainly the cause. You can also open PowerShell as Administrator and run the command below to check for an outbound block rule that targets Rhino. It only lists matching rules — it does not change anything.

Get-NetFirewallRule | Where-Object { $_.Action -eq 'Block' -and $_.Direction -eq 'Outbound' -and $_.Enabled -eq 'True' } | Get-NetFirewallApplicationFilter | Where-Object Program -like '*Rhino*' | Select-Object Program
4

Fix it

Windows Firewall. Open "Windows Defender Firewall with Advanced Security", find the outbound block rule for Rhino 8 (or Rhino.exe) under Outbound Rules, and disable or delete it. As Administrator, you can also run:

Get-NetFirewallRule -DisplayName 'Rhino 8' | Where-Object Direction -eq 'Outbound' | Disable-NetFirewallRule

Security software. In its program network control / network protection settings, set Rhino.exe to allowed.

Company computer. Ask your IT department to allow Rhino.exe to reach designtoolbox.ai on port 443.

After making the change, restart Rhino and sign in again.