Setup

Import your Mastra project to Mastra Cloud to use Studio and optionally deploy your agent.

Before you begin

• Sign in to Cloud
• Push your Mastra project to GitHub

Options

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
3. Create from template - Start from a pre-built template

To create a project from GitHub, follow these steps:

Create from GitHub

1. Connect to GitHub when prompted

   

2. Search for your repository and click Import

   

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:

   

4. Click Create Project

Next steps

Once your project is imported, Studio 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 settings and hit deploy!