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.

110+ Nodes

AI models, specialized agents, Google Workspace, WhatsApp, Telegram, Twitter/X, Android, documents, webhooks, and more

WebSocket-First

Real-time status updates over a single WebSocket connection

AI-Powered

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

Self-Hosted

Full control with the machina CLI, Temporal distributed execution, and encrypted credentials

​
Key Features

​
AI Integration

Connect to 11 LLM providers with built-in conversation memory, tool calling, and thinking modes.
  • OpenAI - GPT-5.5/5.4/5.2, GPT-4.1/4.1-mini/nano, o3/o4-mini, GPT-4o/4o-mini with response format and reasoning effort
  • Anthropic - Claude Fable 5, Opus 4.8/4.7, Sonnet 4.6, Haiku 4.5 with extended thinking via budget_tokens
  • Google Gemini - Gemini 3.5 Flash, 3.1 Pro/Flash-Lite, 3 Flash, 2.5 Pro/Flash/Flash-Lite with multimodal support and thinking budget
  • OpenRouter - 200+ models via unified API (OpenAI, Claude, Llama, Mistral, and more)
  • Groq - Ultra-fast inference with Llama 3.3-70b, Llama 3.1-8b, GPT-OSS-120b/20b, Qwen3-32b
  • Cerebras - Ultra-fast inference on custom wafer-scale hardware (GPT-OSS-120b, Qwen-3-235b, GLM-4.7)
  • DeepSeek - V4 Flash + V4 Pro (up to 1M context)
  • Kimi - Moonshot K2.6 / K2.5 / K2.7-code (256K context)
  • Mistral - Large / Medium / Small / Codestral (up to 256K context)
  • Ollama - Run your locally-pulled models via a local Ollama server
  • LM Studio - Run models loaded in the local LM Studio server
  • AI Agent - Agent loop with tool calling and iterative reasoning
  • Chat Agent - Conversational agent (Zeenie) with skill support for multi-turn chat
  • 16 Specialized Agents - Android, Coding, Web, Task, Social, Travel, Tool, Productivity, Payments, Consumer, Autonomous, Orchestrator, AI Employee, RLM, Claude Code, Codex
  • 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. 16 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, JavaScript, and TypeScript directly in workflows.
  • Syntax-highlighted editor with per-theme code colors
  • Access to input_data from connected nodes
  • Console output capture
  • Sandboxed Python execution via Monty with enforced time and memory limits

Installation

Get MachinaOs running locally in minutes

Quick Start

Build your first workflow in 5 minutes

Node Catalog

Explore the full node library

Tutorials

Step-by-step guides

​
Architecture Overview

MachinaOs follows n8n-inspired architectural patterns with modular backend services:
LayerTechnology
FrontendReact 19, TypeScript, React Flow, Tailwind + shadcn/ui, Zustand, TanStack Query
BackendPython FastAPI, SQLAlchemy, plugin-first node system
Real-timeWebSocket-first status + RPC
ExecutionTemporal distributed workflow execution
WhatsAppGo service with whatsmeow library
CacheRedis (production) / SQLite (dev) / Memory fallback
Deploymentmachina deploy up --provider gcp (Terraform + machina serve under systemd)

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