# Setup

Import your Mastra project to [Mastra Cloud](https://cloud.mastra.ai) to use [Studio](https://mastra.ai/docs/mastra-cloud/overview) and optionally [deploy](https://mastra.ai/docs/mastra-cloud/deployment) your agent.

## Before you begin

- [Sign in](https://cloud.mastra.ai) to Cloud
- Push your [Mastra project](https://mastra.ai/docs) to GitHub

## Options

![Select project type](/assets/images/mastra-cloud-select-6b31837ad5bcfb2be5f8085a524b576c.png)

When you create a new project, you can choose from three options:

1. **Create from GitHub** - Import a Mastra project from GitHub
2. **Create from your server** - Connect a self-hosted Mastra instance to [Studio](https://mastra.ai/docs/mastra-cloud/overview)
3. **Create from template** - Start from a [pre-built template](https://mastra.ai/templates)

To create a project from GitHub, follow these steps:

## Create from GitHub

1. Connect to GitHub when prompted

   ![Deployment details](/assets/images/mastra-cloud-connect-3d62fb8eb348f63097d77079610a6d90.png)

2. Search for your repository and click **Import**

   ![Deployment details](/assets/images/mastra-cloud-import-git-repository-bed773afbf510103f535451cbee5040f.jpg)

3. Configure your project settings. Mastra Cloud auto-detects most settings, but you'll still need to enter the environment variables for your configured [model provider](https://mastra.ai/models):

   ![Deployment details](/assets/images/mastra-cloud-deployment-details-e2c25f0d7d3ede4add9f8a907784c829.jpg)

4. Click **Create Project**

## Next steps

Once your project is imported, [Studio](https://mastra.ai/docs/mastra-cloud/overview) automatically creates a sandbox where you can interact with your agents and share access with your team.

When you're ready for production, enable [Deployment](https://mastra.ai/docs/mastra-cloud/deployment) settings and hit deploy!