Skip to main content

​
Welcome to MachinaOs

MachinaOs is an open-source workflow automation platform inspired by n8n, built with React Flow and Python FastAPI. Create powerful automations using a visual node-based editor with real-time execution feedback.

96 Nodes

AI models, 15 specialized agents, Google Workspace, WhatsApp, Android, documents, webhooks, and more

WebSocket-First

89 WebSocket message handlers for real-time status updates

AI-Powered

10 LLM providers with conversation memory, tool calling, and thinking modes

Self-Hosted

Full control with Docker deployment, Temporal distributed execution, and encrypted credentials

​
Key Features

​
AI Integration

Connect to 10 LLM providers with built-in conversation memory, tool calling, and thinking modes.
  • OpenAI - GPT-4.x, GPT-5.x, o1, o3, o4-mini with response format and reasoning effort
  • Anthropic - Claude 4.x Opus/Sonnet/Haiku with extended thinking via budget_tokens
  • Google Gemini - Gemini 2.5 Pro/Flash, Gemini 3 with multimodal support and thinking budget
  • OpenRouter - 200+ models via unified API (OpenAI, Claude, Llama, Mistral, and more)
  • Groq - Ultra-fast inference with Llama 4, Qwen3, GPT-OSS
  • Cerebras - Ultra-fast inference on custom wafer-scale AI hardware
  • xAI - Grok models via OpenAI-compatible API
  • DeepSeek - V3 Chat + Reasoner (always-on Chain-of-Thought)
  • Kimi - Moonshot K2.5 / K2-thinking (256K context)
  • Mistral - Large / Small / Codestral (up to 256K context)
  • AI Agent - LangGraph agent with tool calling and iterative reasoning
  • Chat Agent - Conversational agent (Zeenie) with skill support for multi-turn chat
  • 15 Specialized Agents - Android, Coding, Web, Task, Social, Travel, Tool, Productivity, Payments, Consumer, Autonomous, Orchestrator, AI Employee, RLM, Claude Code
  • Simple Memory - Markdown-based conversation history with long-term vector storage

​
WhatsApp Automation

Send and receive WhatsApp messages with event-driven triggers.
  • QR code pairing via Go WhatsApp bridge (whatsmeow)
  • Message filtering: sender, group, keywords, forwarded status
  • Group/sender name persistence for display

​
Android Device Control

Automate Android devices via local ADB or remote WebSocket relay. 17 Service Nodes:
  • System Monitoring: battery, network, system info, location
  • App Management: launcher, app list
  • Device Automation: WiFi, Bluetooth, audio, device state, screen control, airplane mode
  • Sensors: motion detection, environmental sensors
  • Media: camera control, media playback

​
Webhooks & HTTP

Event-driven webhook triggers and HTTP client for external APIs.
  • Dynamic webhook endpoints at /webhook/{path}
  • HTTP Request node with GET, POST, PUT, DELETE, PATCH
  • Webhook Response for custom responses

​
Code Execution

Execute Python code directly in workflows.
  • Syntax-highlighted editor with Dracula theme
  • Access to input_data from connected nodes
  • Console output capture

Installation

Get MachinaOs running locally in minutes

Quick Start

Build your first workflow in 5 minutes

Node Catalog

Explore all 60 nodes

Tutorials

Step-by-step guides

​
Architecture Overview

MachinaOs follows n8n-inspired architectural patterns with modular backend services:
LayerTechnology
FrontendReact 19, TypeScript, React Flow, Zustand
BackendPython FastAPI, SQLAlchemy, LangChain
Real-timeWebSocket (25 message handlers)
WhatsAppGo service with whatsmeow library
CacheRedis (production) / SQLite (dev) / Memory fallback
DeploymentDocker Compose (4 containers), nginx reverse proxy

​
Backend Service Architecture

server/services/
├── workflow.py              # Facade (~460 lines)
├── node_executor.py         # Registry-based dispatch
├── parameter_resolver.py    # Template variable resolution
├── deployment/              # Event-driven lifecycle
│   ├── manager.py           # Deploy, cancel, status
│   └── triggers.py          # Cron and event triggers
└── execution/               # Parallel orchestration
    ├── executor.py          # Conductor decide pattern
    └── cache.py             # Redis/SQLite persistence
MachinaOs is designed for self-hosting. Your data stays on your infrastructure with automatic cache fallback for any environment.