> 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/courses/finch-101/finch-101-starting-a-project-in-finch.md).

# Finch 101: Starting a project in Finch

{% embed url="<https://www.youtube.com/watch?v=RkOkdr1jNvc&list=PLAT8LHZMhh0HbJ-13-kC0wWOHm5lHDPn9>" %}

### 1. Explore the Sample Project

When you first log into Finch, you'll see a <mark style="background-color:$info;">**`Finch Sample Project`**</mark> already created for you.

Open this project to get familiar with:

* **Project location**
* **Variants** (versions of your design)
* **Variant bundles** (groupings of variants)

***Tip**: Spend a few minutes exploring the sample project to understand how Finch displays design data.*

***

### 2. Create a New Project

**Click the `Finch Icon` → `Create New`**

* Click the **Finch logo** at the top left to return to your **Projects list**.
* Click **Create New** and give your project a name (e.g., *Boston*).
* Click **OK**.

Finch will now open your new project, starting inside a default variant.

***

### 3. Visit the Project Overview

Click the **`project name`** (e.g., *Boston*) in the top left to return to the **project overview**.

Here you can:

* **Set your project location**
* **Rename the project**
* **Invite team members** (for Enterprise users)
* **Switch measurement units** between **metric** and **imperial**

***

### 4. Work with Variants

Variants allow you to **test multiple building volumes** within the same project.

You can:

* Upload different conceptual masses
* **Duplicate a variant** to test different interior layouts with the same volume

**Example**: *Keep the building volume but test two different floorplate strategies by duplicating the variant.*

***

### 5. Use Variant Bundles

If you’re working on a **master plan** or multiple buildings, group your variants into a **variant bundle**. This helps with:

* **Visualizing multiple volumes**
* **Viewing key metrics across multiple buildings**
* **Collaborating in parallel** with multiple team members

***

### 6. Ready to Upload a Volume

Once your project is set up, click into **Variant 1** to begin working.

In the next tutorial, we’ll walk through how to **upload your first mass** into Finch.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.finch3d.com/courses/finch-101/finch-101-starting-a-project-in-finch.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.