> For the complete documentation index, see [llms.txt](https://docs.finch3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.finch3d.com/docs/first-steps/grasshopper.md).

# Grasshopper

The Finch components in Grasshopper: how to connect them to a Variant, and the guide for each task from uploading geometry to generating plans.

Use your Grasshopper definition as the input to Finch: upload geometry and libraries, generate plans, and read the results back as geometry and data.

To sign in, type `Finch` in Rhino to open the Finch panel and use its **Account** tab. Then pick your Project and Variant on the panel's **Project** tab and choose **Load Variant**. Start every definition with the **Finch** component (**Finch** tab › **Reference**), which connects to the Project and Variant you picked.

**Generate Plan** finds plan templates from your libraries that fit a boundary curve you draw.

{% hint style="info" %}
Generate Plan is available on Enterprise. [Compare plans](https://finch3d.com/pricing)
{% endhint %}

## What you can do

| Task                                                       | Where in the plug-in                                     | Guide                                                                                                                                                             |
| ---------------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Upload a mass, walls, site boundary and reference geometry | **Finch** tab › **Hierarchy** › **Building Mass Upload** | [Upload building data from Grasshopper](https://docs.finch3d.com/docs/first-steps/grasshopper/upload-building-data-from-grasshopper.md)                           |
| Upload windows and balconies                               | **Finch** tab › **Hierarchy** › **Window Upload**        | [Upload windows and balconies from Grasshopper](https://docs.finch3d.com/docs/first-steps/grasshopper/upload-windows-and-balconies-from-grasshopper.md)           |
| Upload objects and plans to your libraries                 | **Finch** tab › **Libraries**                            | [Upload objects and plans to your libraries from Grasshopper](https://docs.finch3d.com/docs/first-steps/grasshopper/upload-objects-and-plans-from-grasshopper.md) |
| Generate plans                                             | **Finch** tab › **GeneratePlans** › **Generate Plan**    | [Generate plans in Grasshopper](https://docs.finch3d.com/docs/first-steps/grasshopper/generate-plans-in-grasshopper.md)                                           |
| Download Finch data into Grasshopper                       | **Finch** tab › **Reference** › **Finch**                | [Download data to Grasshopper](https://docs.finch3d.com/docs/first-steps/grasshopper/download-data-to-grasshopper.md)                                             |

## Before you start

* The Finch plug-in is installed in Rhino. See [Download plug-ins](https://docs.finch3d.com/docs/download-plug-ins.md#rhino).
* You have a Finch account with a Project and a Variant to work in. See [Iterate with variants](https://docs.finch3d.com/docs/projects-and-variants/iterate-with-variants.md).

## See also

{% content-ref url="/pages/osR5MHkKDNBvHHKMusKP" %}
[Grasshopper component reference](https://docs.finch3d.com/docs/first-steps/grasshopper/grasshopper-component-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/y8AZTj7IWAkVdbUHzwf6" %}
[Download plug-ins](https://docs.finch3d.com/docs/download-plug-ins.md)
{% endcontent-ref %}
