Motia NPM | npm.io

Motia

What is Motia?

Motia is a lightweight, flexible framework for building complex workflows and business processes across multiple programming languages. It allows you to define, visualize, and execute workflows with a clean, declarative API in JavaScript, TypeScript, Ruby, Python, and more languages coming soon.

Key features:

🔄 Declarative Workflows: Define complex processes with a simple, readable syntax
🛠️ Type-Safe: Built with strong typing support for all supported languages
🔍 Visualizable: Inspect and debug your workflows with Motia Workbench
🧩 Composable: Build complex workflows from reusable components
🚀 Multi-Language Support: Works with JavaScript, TypeScript, Ruby, Python, with more languages coming soon
🌐 Framework Agnostic: Integrates with any framework in your language of choice

Installation

JavaScript/TypeScript

npm install motia
# or
yarn add motia
# or
pnpm add motia

Quick Start

Ready to get started in minutes? Follow these simple steps using pnpm and the automated project creation:

Create a new project using the Motia CLI:
```
npx motia create -t default -n my-motia-project
```
(Replace my-motia-project with your desired project name)
This command will:
- Create a new folder my-motia-project
- Set up a basic Motia project with example steps
- Install dependencies using pnpm
Navigate into your new project directory:
```
cd my-motia-project
```
Start the Motia development server:
```
pnpm run dev
```
This will launch the Motia server and the Workbench UI (typically at http://localhost:3000).
Open the Motia Workbench in your browser (usually http://localhost:3000). You should see a pre-built flow named "default" with example steps visualized.
Test an example API Step: In your terminal, use curl to trigger the example API endpoint (often /default in the default template):
```
curl -X POST http://localhost:3000/default \
-H "Content-Type: application/json" \
-d '{}'
```
Alternatively, use the Motia CLI to emit an event (for event-based steps in the template):
```
npx motia emit --topic test-state --message '{}'
```
Check the Workbench logs – you should see logs indicating the step execution and event flow!