🔥 A Modern Unified Backend Framework for APIs, Events and Agents 🔥

💡 Motia Manifesto • 🚀 Quick Start • 📋 Defining Steps • 📚 Docs

Motia is a modern backend framework that unifies APIs, background jobs, events, and AI agents into a single cohesive system. Eliminate runtime complexity and build unified backends where JavaScript, TypeScript, Python, etc, work together in event-driven workflows, with built-in state management, observability, and one-click deployments.

Motia brings cohesion to the fragmented backend world with our core primitive: the Step. Think of Steps like React Components, but for backends.

• 🎯 Single Purpose: Each Step performs one task
• 🌍 Language agnostic: Each Step can be in a different language while being part of the same workflow
• ⚡ Versatile: Steps can trigger APIs, background jobs, and AI Agents
• 👁️ Observable: Everything is observable by default
• 🌊 Workflows: Collections of connected steps that form complete processes
• 🏪 State Management: Shared state across all steps with full traceability

Backend teams juggle fragmented runtimes across APIs, background queues, and AI agents. This creates deployment complexity, debugging gaps, and cognitive overhead from context-switching between frameworks.

This fragmentation demands a unified system.

Motia unifies your entire backend into a unified state. APIs, background jobs, and AI agents become interconnected Steps with shared state and integrated observability.

Get up and running in under 60 seconds:

npx motia@latest create -i

• Enter project details like template, project name, etc

Open 01-api.step.ts and create a simple API endpoint:

exports.config = {
  type: 'api',           // Step type: "api", "event", "cron", or "noop"
  path: '/hello-world',  // API endpoint path
  method: 'GET',         // HTTP method
  name: 'HelloWorld',    // Step identifier
  emits: ['test-state'], // Events this step emits
  flows: ['default'],    // Flow this step belongs to
}

exports.handler = async () => {
  return {
    status: 200,
    body: { message: 'Hello World from Motia!' },
  }
}

Start the visual development environment:

npm run dev
# Opens at http://localhost:3000

🎉 That's it! You now have a fully functional Motia app with:

• ✅ API endpoint at /hello-world
• ✅ Visual debugger and flow inspector
• ✅ Built-in observability
• ✅ Hot reload for instant feedback

From the Workbench, navigate to:

• 📊 Logs: Structured logs for each step execution with inputs, outputs, and errors
• 🏪 States: View internal state and data passed between steps using traceID
• 🔌 Endpoints: Test all your API endpoints directly from the UI
• 🌊 Flows: Visually inspect how your steps connect and what each step does

Finance Agent	GitHub Agent	Gmail Manager
Financial insights	PR automation	Email automation

Trello Automation	RAG Agent	AI Image Gen
Task automation	Knowledge retrieval	Generate images

Write steps in your preferred language:

• 📋 Questions: Use our Discord community
• 🐛 Bug Reports: GitHub Issues
• 📖 Documentation: Official Docs
• 🎥 Blog: Motia Blog

We're building Motia in the open, and we'd love for you to be a part of the journey.

Check out our public roadmap to see what’s planned, what’s in progress, and what’s recently shipped:

👉 View our public Roadmap

We welcome contributions! Whether it's:

• 🐛 Bug fixes and improvements
• ✨ New features and step types
• 📚 Documentation and examples
• 🌍 Language support additions
• 🎨 Workbench UI enhancements

Check out our Contributing Guide to get started.