Skip to main content

​
Node Overview

MachinaOs uses a visual node-based system for building workflows. Each node performs a specific function and passes data to connected nodes.

​
Node Categories

The node palette groups plugins by category. The exact node count grows as new plugins ship, so use the palette in the app for the live list.
CategoryDescription
AI Chat ModelsOpenAI, Anthropic, Gemini, OpenRouter, Groq, Cerebras, DeepSeek, Kimi, Mistral, Ollama, LM Studio
AI Agents and MemoryAI Agent, Chat Agent (Zeenie), Simple Memory
Specialized AgentsAndroid, Coding, Web, Task, Social, Travel, Tool, Productivity, Payments, Consumer, Autonomous, Orchestrator, AI Employee, RLM, Claude Code, Codex
AI SkillsMaster Skill aggregator (built-in skill library)
AI ToolsCalculator, Time, DuckDuckGo, Task Manager, Write Todos
SearchBrave, Serper, Perplexity (dual-purpose)
Google WorkspaceGmail, Gmail Receive, Calendar, Drive, Sheets, Tasks, Contacts
WhatsAppSend, Receive, DB query (dual-purpose)
Twitter/XSend, Search, User, Receive (dual-purpose)
TelegramSend, Receive
Social (unified)socialReceive, socialSend
EmailSend, Read, Receive (IMAP/SMTP, dual-purpose)
StripeStripe action (CLI pass-through), Stripe receive (webhook trigger)
AndroidDevice control and monitoring (16 service nodes)
LocationGoogle Maps (create, geocode, nearby)
Code ExecutorsPython, Monty (sandboxed Python), JavaScript, TypeScript (dual-purpose)
Filesystem and ShellFile read, file modify, shell (Nushell), fs search, process manager
BrowserInteractive browser automation (dual-purpose)
Webhooks and UtilitiesHTTP, webhook trigger/response, chat trigger, console, team monitor
ProxyResidential proxy request, config, status
DocumentsRAG pipeline: scrape, parse, embed, store
Web ScrapingApify actor, Crawlee scraper
ChatChat send, chat history
SchedulersTimer, cron scheduler
Workflow triggersStart, task trigger

​
Node Shapes

Different shapes indicate different node types:
ShapeTypeDescription
DiamondTriggerStarts a workflow (no input handle)
SquareActionPerforms operations
CircleConfigProvides configuration to other nodes

​
Handles

Handles are connection points on nodes:

​
Input Handles (Left Side)

  • Main Input - Receives data from upstream nodes
  • Config Inputs - Diamond shapes for memory, model, etc.

​
Output Handles (Right Side)

  • Main Output - Sends data to downstream nodes

​
Data Flow

Data flows from left to right through connections: 
[Trigger] --> [Process] --> [Action] --> [Response]

​
Template Variables

Access upstream data using template syntax: 
{{nodeName.fieldName}}
Examples: 
{{webhookTrigger.body}}           // Webhook request body
{{openaiChatModel.response}}      // AI model response
{{batteryMonitor.level}}          // Battery percentage
{{whatsappReceive.text}}          // Message content

​
Nested Fields

Access nested objects with dot notation: 
{{whatsappReceive.group_info.sender_name}}
{{webhookTrigger.body.user.email}}

​
Node Configuration

​
Opening Parameters

  1. Click the node to select it
  2. Click gear icon or double-click to open parameter panel

​
Parameter Types

TypeDescription
TextString input
NumberNumeric input
BooleanToggle on/off
OptionsDropdown selection
SliderRange selection
CodeMulti-line code editor
JSONJSON object input

​
Dynamic Options

Some parameters load options from the backend:
  • Device lists (Android)
  • AI models (based on API key)
  • Groups and contacts (WhatsApp)

​
Node States

During execution, nodes show their state:
StateIndicatorDescription
IdleDefaultNot running
WaitingCyanTrigger waiting for event
RunningPurple glowCurrently executing
CompletedGreenFinished successfully
ErrorRedFailed with error

​
Special Node Types

​
Trigger Nodes

  • No input handle
  • Start workflow execution
  • Wait for external events
Examples: Webhook Trigger, WhatsApp Receive, Cron Scheduler

​
Config Nodes

  • Connect to special config handles (diamonds)
  • Provide settings to parent nodes
  • Don’t execute independently
Examples: Simple Memory, AI Models

​
Renaming Nodes

Give nodes meaningful names:
  1. Press F2 with node selected
  2. Or double-click the node label
  3. Or right-click > Rename

​
Copying Nodes

  1. Select node(s)
  2. Press Ctrl+C to copy
  3. Press Ctrl+V to paste

​
Deleting Nodes

  1. Select node(s)
  2. Press Delete or Backspace

​
Best Practices

Name your nodes descriptively. “Process Order” is better than “AI Agent 1”.
Test individual nodes with the Run button before deploying full workflows.
Config nodes (Memory, Models) connect to diamond handles, not main inputs.

​
Node Reference

AI Models

11 providers: OpenAI, Claude, Gemini, OpenRouter, Groq, Cerebras, DeepSeek, Kimi, Mistral, Ollama, LM Studio

AI Agents

AI Agent, Chat Agent (Zeenie), and 16 specialized agents

AI Skills

Master Skill aggregator with a built-in skill library

AI Tools

Calculator, time, search, Android toolkit

WhatsApp

Send, receive, and query messages

Android

16 device control nodes

Documents

RAG pipeline: scrape, parse, embed, store

Webhooks

HTTP, webhooks, and utilities