machinaos 0.0.1

package/docs-MachinaOs/tutorials/android-automation.mdx

@@ -0,0 +1,242 @@
+---
+title: Android Automation
+description: Control Android devices via ADB or remote relay
+---
+
+# Android Automation
+
+MachinaOs can control Android devices for automation tasks like launching apps, monitoring battery, controlling WiFi, and more.
+
+## Connection Methods
+
+| Method | Use Case |
+|--------|----------|
+| **Local ADB** | Device connected via USB to your machine |
+| **Remote Relay** | Device connected via WebSocket relay server |
+
+## Step 1: Set Up Connection
+
+### Option A: Local ADB
+
+1. Enable **Developer Options** on your Android device
+2. Enable **USB Debugging**
+3. Connect device via USB
+4. Run `adb devices` to verify connection
+
+### Option B: Remote Relay
+
+1. Click the **Android icon** in the toolbar
+2. Enter your relay URL and API key in Credentials
+3. Click **Connect**
+4. Scan the QR code with the companion Android app
+
+<Info>
+Remote relay allows controlling devices anywhere with internet access.
+</Info>
+
+## Step 2: Add Android Device Setup
+
+1. Drag **Android Device Setup** from Android category
+2. Configure connection type:
+
+**Local ADB:**
+```
+Connection Type: Local ADB Device
+Device ID: [Select from dropdown]
+Auto Forward: true
+Port: 8888
+```
+
+**Remote:**
+```
+Connection Type: Remote WebSocket
+```
+
+## Available Android Nodes
+
+### System Monitoring
+| Node | Description |
+|------|-------------|
+| Battery Monitor | Battery level, charging status, temperature |
+| Network Monitor | WiFi/cellular status, internet connectivity |
+| System Info | Device model, Android version, memory |
+| Location | GPS coordinates, accuracy, provider |
+
+### App Management
+| Node | Description |
+|------|-------------|
+| App Launcher | Launch apps by package name |
+| App List | Get installed applications |
+
+### Automation
+| Node | Description |
+|------|-------------|
+| WiFi Automation | Enable/disable WiFi, scan networks |
+| Bluetooth Automation | Toggle Bluetooth, list paired devices |
+| Audio Automation | Volume control, mute/unmute |
+| Device State | Airplane mode, brightness, screen |
+| Screen Control | Wake screen, timeout settings |
+
+### Sensors
+| Node | Description |
+|------|-------------|
+| Motion Detection | Accelerometer, gyroscope, shake detection |
+| Environmental Sensors | Temperature, humidity, pressure, light |
+
+### Media
+| Node | Description |
+|------|-------------|
+| Camera Control | Take photos, get camera info |
+| Media Control | Playback control, volume |
+
+## Example: Battery Alert Workflow
+
+Create a workflow that sends an alert when battery is low.
+
+### Workflow Design
+
+```
+[Cron Scheduler] --> [Battery Monitor] --> [Python Executor] --> [WhatsApp Send]
+                                               (check level)
+```
+
+### Step 1: Add Cron Trigger
+```
+Cron Expression: */10 * * * *  (every 10 minutes)
+```
+
+### Step 2: Add Battery Monitor
+```
+Action: Get Status
+```
+
+### Step 3: Add Python Executor
+```python
+battery_level = input_data.get("level", 100)
+is_charging = input_data.get("is_charging", False)
+
+if battery_level < 20 and not is_charging:
+    output = {
+        "alert": True,
+        "message": f"Battery low: {battery_level}%"
+    }
+else:
+    output = {"alert": False}
+```
+
+### Step 4: Add WhatsApp Send (conditional)
+```
+Phone Number: +1234567890
+Message: {{pythonExecutor.message}}
+```
+
+## Example: App Launcher Workflow
+
+Launch an app when receiving a webhook.
+
+```
+[Webhook Trigger] --> [App Launcher]
+```
+
+**App Launcher Config:**
+```
+Package Name: {{webhookTrigger.body.app}}
+```
+
+**Test:**
+```bash
+curl -X POST http://localhost:3010/webhook/launch \
+  -H "Content-Type: application/json" \
+  -d '{"app": "com.spotify.music"}'
+```
+
+## Example: WiFi Toggle
+
+```
+[Webhook Trigger] --> [WiFi Automation]
+```
+
+**WiFi Automation Config:**
+```
+Action: {{webhookTrigger.body.action}}
+```
+
+**Test:**
+```bash
+# Enable WiFi
+curl -X POST http://localhost:3010/webhook/wifi \
+  -d '{"action": "enable"}'
+
+# Disable WiFi
+curl -X POST http://localhost:3010/webhook/wifi \
+  -d '{"action": "disable"}'
+```
+
+## Battery Monitor Output
+
+```json
+{
+  "level": 85,
+  "is_charging": true,
+  "status": "charging",
+  "plugged": "ac",
+  "temperature": 28.5,
+  "health": "good",
+  "technology": "Li-ion"
+}
+```
+
+## Network Monitor Output
+
+```json
+{
+  "is_connected": true,
+  "type": "wifi",
+  "wifi_ssid": "MyNetwork",
+  "is_internet_available": true,
+  "ip_address": "192.168.1.100"
+}
+```
+
+## Troubleshooting
+
+<Accordion title="Device not showing in dropdown">
+  - Run `adb devices` to check connection
+  - Ensure USB debugging is enabled
+  - Try different USB cable/port
+  - Restart ADB: `adb kill-server && adb start-server`
+</Accordion>
+
+<Accordion title="Remote relay won't connect">
+  - Verify relay URL is correct
+  - Check API key is valid
+  - Ensure companion app is installed on device
+  - Check firewall settings
+</Accordion>
+
+<Accordion title="Commands fail with permission error">
+  - Some actions require root access
+  - Use device automation apps for restricted features
+  - Check Android version compatibility
+</Accordion>
+
+## Tips
+
+<Tip>
+Start with Battery Monitor and System Info to verify your connection works before building complex workflows.
+</Tip>
+
+<Tip>
+Use meaningful node names (F2 to rename) when building workflows with multiple Android nodes.
+</Tip>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Android Node Reference" icon="mobile" href="/nodes/android">
+    Full documentation for all 17 nodes
+  </Card>
+  <Card title="Webhooks" icon="webhook" href="/nodes/webhooks">
+    Trigger Android actions via HTTP
+  </Card>
+</CardGroup>

package/docs-MachinaOs/tutorials/first-workflow.mdx

@@ -0,0 +1,134 @@
+---
+title: Your First Workflow
+description: Learn the basics of building workflows in MachinaOs
+---
+
+# Your First Workflow
+
+This tutorial covers the fundamentals of creating workflows in MachinaOs.
+
+## Understanding the Interface
+
+### Canvas
+The main area where you build workflows by connecting nodes.
+
+### Component Palette
+Left sidebar with all available nodes organized by category:
+- **AI Models** - Chat models (OpenAI, Claude, Gemini)
+- **AI Agents** - Agent and memory nodes
+- **WhatsApp** - Messaging automation
+- **Android** - Device control
+- **Utilities** - HTTP, webhooks, code execution
+- **Schedulers** - Triggers and timers
+
+### Toolbar
+Top bar with workflow controls:
+- **File** - New, Open, Save, Export
+- **Run** - Execute selected node
+- **Deploy** - Start workflow triggers
+- **Stop** - Cancel execution
+
+## Node Basics
+
+### Adding Nodes
+1. **Drag and drop** from the component palette
+2. **Right-click** on canvas to search nodes
+
+### Connecting Nodes
+- Drag from an **output handle** (right side) to an **input handle** (left side)
+- Handles are the small circles on node edges
+
+### Node Types
+
+| Type | Shape | Description |
+|------|-------|-------------|
+| Trigger | Diamond | Start workflow on events |
+| Action | Square | Perform operations |
+| Config | Circle | Provide configuration to other nodes |
+
+### Configuring Nodes
+1. Click a node to select it
+2. Click the **gear icon** or double-click to open parameters
+3. Set values and click **Save**
+
+## Data Flow
+
+Data flows through connections between nodes. Use template variables to access upstream data:
+
+```
+{{nodeName.outputField}}
+```
+
+### Example
+If a Webhook Trigger outputs `{ body: "Hello" }`:
+
+```
+{{webhookTrigger.body}}  -->  "Hello"
+```
+
+## Building a Simple Workflow
+
+Let's build a workflow that triggers on a schedule and logs the time.
+
+### Step 1: Add a Cron Trigger
+
+1. Drag **Cron Scheduler** from Schedulers
+2. Configure:
+   ```
+   Cron Expression: */5 * * * *  (every 5 minutes)
+   ```
+
+### Step 2: Add a Python Executor
+
+1. Drag **Python Executor** from Utilities
+2. Connect Cron output to Python input
+3. Add this code:
+
+```python
+from datetime import datetime
+
+current_time = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+output = {"time": current_time, "message": f"Triggered at {current_time}"}
+```
+
+### Step 3: Deploy
+
+1. Click **Deploy** in the toolbar
+2. The workflow will run every 5 minutes
+3. Click **Stop** to cancel
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+N` | New workflow |
+| `Ctrl+S` | Save workflow |
+| `F2` | Rename selected node |
+| `Delete` | Delete selected node |
+| `Ctrl+C` | Copy node |
+| `Ctrl+V` | Paste node |
+
+## Tips
+
+<Tip>
+**Rename nodes** for clarity. Press `F2` or double-click the node label.
+</Tip>
+
+<Tip>
+**Test individual nodes** by selecting them and clicking **Run** before deploying the full workflow.
+</Tip>
+
+<Warning>
+Always **save your workflow** before deploying. Unsaved changes are lost on refresh.
+</Warning>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="AI Agent Workflow" icon="robot" href="/tutorials/ai-agent-workflow">
+    Build an intelligent agent with memory
+  </Card>
+  <Card title="Node Overview" icon="grid" href="/nodes/overview">
+    Learn about all node types
+  </Card>
+</CardGroup>

package/docs-MachinaOs/tutorials/whatsapp-automation.mdx

@@ -0,0 +1,185 @@
+---
+title: WhatsApp Automation
+description: Send and receive WhatsApp messages automatically
+---
+
+# WhatsApp Automation
+
+Automate WhatsApp messaging with MachinaOs. Receive messages, process them, and send responses.
+
+## Prerequisites
+
+- MachinaOs running with the WhatsApp service
+- A WhatsApp account for pairing
+
+## Understanding WhatsApp Nodes
+
+| Node | Purpose |
+|------|---------|
+| **WhatsApp Connect** | Check connection status |
+| **WhatsApp Receive** | Trigger on incoming messages |
+| **WhatsApp Send** | Send messages to contacts/groups |
+
+## Step 1: Connect WhatsApp
+
+1. Click the **WhatsApp icon** in the toolbar (or add WhatsApp Connect node)
+2. A modal appears with a QR code
+3. Open WhatsApp on your phone > Settings > Linked Devices > Link a Device
+4. Scan the QR code
+5. Wait for "Connected" status
+
+<Warning>
+Keep the WhatsApp service running. If it stops, you'll need to re-scan the QR code.
+</Warning>
+
+## Step 2: Create a Message Responder
+
+Let's build a workflow that auto-replies to incoming messages.
+
+### Add WhatsApp Receive Trigger
+
+1. Drag **WhatsApp Receive** from the WhatsApp category
+2. Configure the trigger:
+
+```
+Message Type Filter: All Messages
+Sender Filter: All Messages
+Ignore Own Messages: true
+```
+
+### Filter Options
+
+| Filter | Description |
+|--------|-------------|
+| All Messages | Receive everything |
+| From Any Contact | Non-group messages only |
+| From Specific Contact | Filter by phone number |
+| From Specific Group | Filter by group |
+| Contains Keywords | Match specific words |
+
+## Step 3: Add an AI Response
+
+1. Drag **OpenAI Chat Model** onto the canvas
+2. Connect WhatsApp Receive output to AI input
+3. Configure:
+
+```
+Model: gpt-4o-mini
+Prompt: "Reply to this WhatsApp message: {{whatsappReceive.text}}"
+```
+
+## Step 4: Send the Response
+
+1. Drag **WhatsApp Send** onto the canvas
+2. Connect AI output to WhatsApp Send input
+3. Configure:
+
+```
+Phone Number: {{whatsappReceive.sender_phone}}
+Message: {{openaiChatModel.response}}
+```
+
+## Complete Workflow
+
+```
+[WhatsApp Receive] --> [OpenAI Chat] --> [WhatsApp Send]
+```
+
+## Step 5: Deploy
+
+1. Click **Deploy**
+2. Send a message to your linked WhatsApp number
+3. The workflow triggers and sends an AI response
+
+## Available Data from WhatsApp Receive
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `message_id` | string | Unique message ID |
+| `sender` | string | Sender JID |
+| `sender_phone` | string | Phone number |
+| `chat_id` | string | Chat/group ID |
+| `message_type` | string | text, image, video, etc. |
+| `text` | string | Message content |
+| `timestamp` | string | When message was sent |
+| `is_group` | boolean | True if from a group |
+| `is_from_me` | boolean | True if sent by you |
+| `push_name` | string | Sender's display name |
+| `is_forwarded` | boolean | True if forwarded |
+| `group_info` | object | Group details (if group message) |
+
+## Group Message Handling
+
+For group messages, use:
+
+```
+{{whatsappReceive.group_info.group_jid}}
+{{whatsappReceive.group_info.sender_name}}
+{{whatsappReceive.group_info.sender_phone}}
+```
+
+## Example: Keyword-Based Response
+
+Set up different responses based on keywords:
+
+### Configuration
+```
+Sender Filter: Contains Keywords
+Keywords: help, support, question
+```
+
+### AI Prompt
+```
+The user needs help. Their message: {{whatsappReceive.text}}
+Provide a helpful response.
+```
+
+## Example: Group Bot
+
+Reply only in specific groups:
+
+```
+Sender Filter: From Specific Group
+Group: [Select from dropdown]
+```
+
+## Troubleshooting
+
+<Accordion title="QR code not appearing">
+  - Ensure the WhatsApp service is running on port 5000
+  - Check Docker logs: `docker-compose logs whatsapp`
+  - Restart the service: `docker-compose restart whatsapp`
+</Accordion>
+
+<Accordion title="Messages not being received">
+  - Verify the trigger is deployed (not just saved)
+  - Check "Ignore Own Messages" setting
+  - Ensure filters aren't too restrictive
+</Accordion>
+
+<Accordion title="Send fails with error">
+  - Verify phone number format (include country code)
+  - Check WhatsApp connection status
+  - Ensure recipient hasn't blocked you
+</Accordion>
+
+## Tips
+
+<Tip>
+Use **Simple Memory** with WhatsApp for context-aware conversations. Set Session ID to `{{whatsappReceive.sender_phone}}` for per-contact memory.
+</Tip>
+
+<Tip>
+Test with your own number first before deploying to production.
+</Tip>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Android Automation" icon="mobile" href="/tutorials/android-automation">
+    Control Android devices
+  </Card>
+  <Card title="WhatsApp Node Reference" icon="book" href="/nodes/whatsapp">
+    Full node documentation
+  </Card>
+</CardGroup>

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "machinaos",
+  "version": "0.0.1",
+  "description": "Open source workflow automation platform with AI agents, React Flow, and n8n-inspired architecture",
+  "type": "module",
+  "keywords": [
+    "workflow",
+    "automation",
+    "react-flow",
+    "ai-agent",
+    "langchain",
+    "langgraph",
+    "n8n",
+    "whatsapp",
+    "android",
+    "low-code",
+    "no-code"
+  ],
+  "author": "Rohit G <trohitg@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/trohitg/MachinaOS#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/trohitg/MachinaOS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/trohitg/MachinaOS/issues"
+  },
+  "bin": {
+    "machinaos": "./bin/cli.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "workspaces": [
+    "client"
+  ],
+  "scripts": {
+    "dev": "concurrently --raw --kill-others-on-fail \"npm:client:dev\" \"npm:python:dev\" \"npm:whatsapp:api\"",
+    "dev:temporal": "concurrently --raw --kill-others-on-fail \"npm:client:dev\" \"npm:python:dev\" \"npm:whatsapp:api\" \"npm:temporal:worker\"",
+    "temporal:worker": "cd server && uv run python -m services.temporal.worker",
+    "client:dev": "cd client && npm run dev",
+    "python:dev": "cd server && uv run uvicorn main:app --host 127.0.0.1 --port 3010 --reload --reload-dir . --reload-exclude \"*.pyc\" --reload-exclude \"__pycache__\" --log-level warning",
+    "whatsapp:start": "cd server/whatsapp-rpc && npm start",
+    "whatsapp:stop": "cd server/whatsapp-rpc && npm stop",
+    "whatsapp:status": "cd server/whatsapp-rpc && npm run status",
+    "whatsapp:api": "cd server/whatsapp-rpc && npm run api",
+    "whatsapp:build": "cd server/whatsapp-rpc && npm run build",
+    "build": "node scripts/build.js",
+    "clean": "node scripts/clean.js",
+    "start": "node scripts/start.js",
+    "stop": "node scripts/stop.js",
+    "docker:up": "node scripts/docker.js up",
+    "docker:down": "node scripts/docker.js down",
+    "docker:logs": "node scripts/docker.js logs",
+    "docker:build": "node scripts/docker.js build",
+    "docker:restart": "node scripts/docker.js restart",
+    "docker:prod:up": "docker-compose -f docker-compose.prod.yml up -d",
+    "docker:prod:down": "docker-compose -f docker-compose.prod.yml down",
+    "docker:prod:build": "docker-compose -f docker-compose.prod.yml build",
+    "docker:prod:logs": "docker-compose -f docker-compose.prod.yml logs -f",
+    "deploy": "bash deploy.sh",
+    "deploy:gcp": "bash deploy.sh"
+  },
+  "devDependencies": {
+    "concurrently": "^9.2.1",
+    "cross-env": "^7.0.3",
+    "rimraf": "^6.0.1"
+  }
+}