Quick Start

1. Create Your Project

Use npx to create a new Motia project. This single command will scaffold a new application and install all necessary dependencies.

npx motia@latest create

The installer will guide you through a few questions to set up your project, including choosing a template. Once it's done, you will have a new project directory ready to go.

# TypeScript starter
npx motia@latest create my-app --template starter-typescript
 
# JavaScript starter
npx motia@latest create my-app --template starter-javascript
 
# Python starter
npx motia@latest create my-app --template starter-python

2. Start the Development Server

Navigate into your new project directory and start the Motia development server.

cd <your-project-name> # If you've created a new folder for the project, navigate into it
 
npx motia dev

This command starts the Motia runtime and the Workbench, a powerful UI for developing and debugging your workflows. By default, it's available at http://localhost:3000.

3. Run Your First Flow

The starter project comes with a pre-built basic-tutorial flow. Let's run it.

1. Open the Workbench in your browser at http://localhost:3000.
2. Click the Tutorial button on the top right of the workbench.
3. Complete the Tutorial to get an understanding of the basics of Motia and using the Workbench.

Next Steps

Congratulations! You've successfully ran, and observed your first Motia workflow.

• Build your first application from scratch, follow our Build Your First Motia App guide.
• To learn about Motia, dive into our Core Concepts.