What is the Package Manager?
This guide introduces the Rhino Package Manager (a.k.a. Yak).
The Rhino Package Manager assists in the discovery, installation, and management resources in the Rhino ecosystem (Grasshopper included!). Currently it supports Rhino and Grasshopper plug-ins, but the goal is to include things like scripts, materials, viewports, etc. in the future!
The package manager has several goals.
- Make it easier for users to discover and manage plug-ins and more
- Help developers and reusable content authors to share their work
- Provide simple system administration tools
Not wanting to reinvent the wheel, we’ve taken inspiration from Linux and the software development world. The package management system can be broken down into three main areas.
The package server is the heart of the system. Once created, packages are pushed to the server to share them with others. It keeps the packages organised for its clients – the command line tool and Rhino (via integrations).
Integrations provide direct access to the package ecosystem from inside of Rhino. Currently this has been done in two ways; “package restore” for Grasshopper and the package manager UI.
Package restore for Grasshopper
The Rhino Package Manager has been integrated into Grasshopper’s “Unrecognized Objects” dialog, providing package restore functionality. When opening a new file which contains components from a plug-in not installed on the machine, the user is given the option to check the package server for the missing plug-ins and install them directly.
Package Manager UI
The package manager UI is avilable via the
_PackageManager command. It provides a NuGet-style interface that allows
users to search for packages, install them and see if any updates are avilable
to currently installed packages.
Command Line Tool
The command line tool provides a basic interface but with full functionality.
It is modelled on well known domain-specific package managers such as Ruby’s
gem and Python’s
pip. It communicates with the server as well as hooking
into Rhino Accounts for authentication.
On Windows, the tool can be found at
"C:\Program Files\Rhino 7\System\yak.exe".
On Mac there is a script,
<path_to_yak> help to get started.
"/Applications/Rhino 7.app/Contents/Resources/bin/yak"script is broken in Rhino 7.0 and will be fixed in Rhino 7.1 Release Candidate 2. Check the forum for updates.