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

CategoryCountDescription
AI Chat Models9OpenAI, Anthropic, Gemini, OpenRouter, Groq, Cerebras, DeepSeek, Kimi, Mistral
AI Agents and Memory3AI Agent, Chat Agent (Zeenie), Simple Memory
Specialized Agents15Android, Coding, Web, Task, Social, Travel, Tool, Productivity, Payments, Consumer, Autonomous, Orchestrator, AI Employee, RLM, Claude Code
AI Skills1Master Skill aggregator (49 built-in skills)
AI Tools4Calculator, Time, DuckDuckGo, Task Manager
Search3Brave, Serper, Perplexity (dual-purpose)
Google Workspace7Gmail, Gmail Receive, Calendar, Drive, Sheets, Tasks, Contacts
WhatsApp3Send, Receive, DB query (dual-purpose)
Twitter/X4Send, Search, User, Receive (dual-purpose)
Telegram2Send, Receive
Social (unified)2socialReceive, socialSend
Android16Device control and monitoring
Location3Google Maps (create, geocode, nearby)
Code Executors3Python, JavaScript, TypeScript (dual-purpose)
Webhooks6HTTP, webhook trigger/response, chat trigger, console, team monitor
Proxy3Residential proxy request, config, status
Documents6RAG pipeline: scrape, parse, embed, store
Web Scraping2Apify actor, Crawlee scraper
Chat2Chat send, chat history
Schedulers2Timer, cron scheduler
Workflow triggers2Start, task trigger
Total: 96 nodes

​
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

10 providers: OpenAI, Claude, Gemini, OpenRouter, Groq, Cerebras, xAI, DeepSeek, Kimi, Mistral

AI Agents

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

AI Skills

Master Skill aggregator with 49 built-in skills

AI Tools

Calculator, time, search, Android toolkit

WhatsApp

Send, receive, and query messages

Android

17 device control nodes

Documents

RAG pipeline: scrape, parse, embed, store

Webhooks

HTTP, webhooks, and utilities