Skip to content
/ motia Public

Modern Backend Framework that unifies APIs, background jobs, workflows, and AI Agents into a single core primitive with built-in observability and state management.

License

Notifications You must be signed in to change notification settings

MotiaDev/motia

Repository files navigation

Motia Banner

Motia Vercel OSS Program

🔥 The Unified Backend Framework That Eliminates Runtime Fragmentation 🔥

APIs, background jobs, workflows, and AI agents in one system. JavaScript, TypeScript, Python, and more in one codebase.

npm version license GitHub stars Twitter Follow Discord

💡 Motia Manifesto🚀 Quick Start📋 Defining Steps📚 Docs


🎯 What is Motia?

Motia solves backend fragmentation.

Modern software engineering is splintered – APIs live in one framework, background jobs in another, queues have their own tooling, and AI agents are springing up in yet more isolated runtimes. This fragmentation demands a unified system.

Motia unifies APIs, background jobs, workflows, and AI agents into a single coherent system with shared observability and developer experience. Similar to how React simplified frontend development where everything is a component, Motia simplifies backend development where everything is a Step.

Write JavaScript, TypeScript, Python, and more in the same workflow. What used to take 5 frameworks to build now comes out of the box with Motia.

Motia combines APIs, background queues, and AI agents into one system

🚀 Quickstart

Get Motia project up and running in under 60 seconds:

1. Bootstrap a New Motia Project

npx motia@latest create -i   # runs the interactive terminal

Follow the prompts to pick a template, project name, and language. motia-terminal

2. Start the Workbench

Inside your new project folder, launch the dev server:

npx motia dev # ➜ http://localhost:3000

That's it! You have:

  • ✅ REST APIs with validation
  • ✅ Visual debugger & tracing
  • ✅ Multi-language support
  • ✅ Event-driven architecture
  • ✅ Zero configuration

new-workbench

📖 Full tutorial in our docs →

🎯 Step Types

Type Trigger Use Case
api HTTP Request REST endpoints
event Topic subscription Background processing
cron Schedule Recurring jobs
noop Manual External processes

📖 Learn more about Steps →


🎯 Examples

🏆 ChessArena.ai - Full-Featured Production App

A complete chess platform benchmarking LLM performance with real-time evaluation.

Live Website → | Source Code →

ChessArena.ai in action (raw GIF)

Built from scratch to production deployment, featuring:

  • 🔐 Authentication & user management
  • 🤖 Multi-agent LLM evaluation (OpenAI, Claude, Gemini, Grok)
  • 🐍 Python engine integration (Stockfish chess evaluation)
  • 📊 Real-time streaming with live move updates and scoring
  • 🎨 Modern React UI with interactive chess boards
  • 🔄 Event-driven workflows connecting TypeScript APIs to Python processors
  • 📈 Live leaderboards with move-by-move quality scoring
  • 🚀 Production deployment on Motia Cloud

📚 More Examples

View all 20+ examples →

Example Description
AI Research Agent Web research with iterative analysis
Streaming Chatbot Real-time AI responses
Gmail Automation Smart email processing
GitHub PR Manager Automated PR workflows
Finance Agent Real-time market analysis

Features demonstrated: Multi-language workflows • Real-time streaming • AI integration • Production deployment


🌐 Language Support

Language Status
JavaScript ✅ Stable
TypeScript ✅ Stable
Python ✅ Stable
Ruby 🚧 Beta
Go 🔄 Soon

📚 Resources

🚧 Roadmap

We have a public roadmap for Motia, you can view it here.

Feel free to add comments to the issues, or create a new issue if you have a feature request.

Feature Status Link Description
Python Types Planned #485 Add support for Python types
Streams: RBAC Planned #495 Add support for RBAC
Streams: Workbench UI Planned #497 Add support for Workbench UI
Queue Strategies Planned #476 Add support for Queue Strategies
Reactive Steps Planned #477 Add support for Reactive Steps
Point in time triggers Planned #480 Add support for Point in time triggers
Workbench plugins Planned #481 Add support for Workbench plugins
Rewrite our Core in either Go or Rust Planned #482 Rewrite our Core in either Go or Rust
Decrease deployment time Planned #483 Decrease deployment time
Built-in database support Planned #484 Add support for built-in database

🤝 Contributing

We welcome contributions! Check our Contributing Guide to get started.


🚀 Get Started📖 Docs💬 Discord

Star History Chart

Star us if you find Motia useful!

About

Modern Backend Framework that unifies APIs, background jobs, workflows, and AI Agents into a single core primitive with built-in observability and state management.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published