# First project

In this section we will set up a new project.
This involves creating a local project directory holding your project code
and a corresponding Union.ai project to which you will deploy that code using the `union` CLI.

## Create a new Union.ai project

Create a new project in the Union.ai UI by clicking on the project breadcrumb at the top left and selecting **All projects**:

![Select all projects](https://www.union.ai/docs/v1/union/user-guide/_static/images/user-guide/getting-started/first-project/select-all-projects.png)

This will take you to the **Projects list**:

![Projects list](https://www.union.ai/docs/v1/union/user-guide/_static/images/user-guide/getting-started/first-project/projects-list.png)

Click on the **New Project** button and fill in the details for your new project.
For this example, let's create a project called **My project**:

![Create new project](https://www.union.ai/docs/v1/union/user-guide/_static/images/user-guide/getting-started/first-project/create-new-project.png "small")

You now have a project on Union.ai named "My Project" (and with project ID `my-project`) into which you can register your workflows.

> [!NOTE] Default project
> Union.ai provides a default project (called **flytesnacks**) where all your workflows will be registered unless you specify otherwise.
> In this section, however, we will be using the project we just created, not the default.

## Initialize a local project

We will use the `union init` command to initialize a new local project corresponding to the project created on your Union.ai instance:

```shell
$ union init --template union-simple my-project
```

The resulting directory will look like this:

```shell
├── LICENSE
├── README.md
├── hello_world.py
├── pyproject.toml
└── uv.lock
```

> [!NOTE] Local project directory name same as Union.ai project ID
> It is good practice to name your local project directory the same as your
> Union.ai project ID, as we have done here.

Next, let's look at the contents of the local project directory.
Continue to [Understanding the code](https://www.union.ai/docs/v1/union/user-guide/getting-started/first-project/understanding-the-code).

---
**Source**: https://github.com/unionai/unionai-docs/blob/main/content/user-guide/getting-started/first-project.md
**HTML**: https://www.union.ai/docs/v1/union/user-guide/getting-started/first-project/
