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.

34 Nodes

AI models, WhatsApp, Android automation, webhooks, code execution, and more

WebSocket-First

25 WebSocket message types for real-time status updates

AI-Powered

OpenAI, Claude, Gemini with conversation memory and tool calling

Self-Hosted

Full control with Docker deployment and n8n-pattern caching

​
Key Features

​
AI Integration

Connect to leading AI providers with built-in conversation memory and tool calling support.
  • OpenAI - GPT-5.2, GPT-5, o3, o4-mini with response format options
  • Anthropic - Claude Opus 4.5, Claude Sonnet 4.5, Claude Haiku 4.5
  • Google - Gemini 3 Pro, Gemini 3 Flash, Gemini 2.5 Pro with multimodal and safety settings
  • AI Agent - Advanced agent with iterative reasoning and memory input
  • Simple Memory - Session-based conversation history with buffer/window modes

​
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 34 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.