machinaos 0.0.1 → 0.0.6

package/docs-MachinaOs/docs.json

@@ -1,75 +0,0 @@
-{
-  "$schema": "https://mintlify.com/docs.json",
-  "theme": "mint",
-  "name": "MachinaOs",
-  "colors": {
-    "primary": "#16A34A",
-    "light": "#07C983",
-    "dark": "#15803D"
-  },
-  "logo": {
-    "dark": "/logo/dark.svg",
-    "light": "/logo/light.svg"
-  },
-  "favicon": "/favicon.svg",
-  "navigation": {
-    "dropdowns": [
-      {
-        "dropdown": "Documentation",
-        "icon": "book",
-        "groups": [
-          {
-            "group": "Getting Started",
-            "pages": ["introduction", "installation", "quickstart"]
-          },
-          {
-            "group": "Tutorials",
-            "pages": [
-              "tutorials/first-workflow",
-              "tutorials/ai-agent-workflow",
-              "tutorials/whatsapp-automation",
-              "tutorials/android-automation"
-            ]
-          },
-          {
-            "group": "Node Catalog",
-            "pages": [
-              "nodes/overview",
-              "nodes/ai-models",
-              "nodes/ai-agent",
-              "nodes/whatsapp",
-              "nodes/android",
-              "nodes/webhooks",
-              "nodes/schedulers"
-            ]
-          },
-          {
-            "group": "Deployment",
-            "pages": ["deployment/docker", "deployment/production"]
-          },
-          {
-            "group": "FAQ",
-            "pages": ["faq"]
-          }
-        ]
-      }
-    ]
-  },
-  "navbar": {
-    "links": [
-      {
-        "label": "GitHub",
-        "href": "https://github.com/trohitg/MachinaOs"
-      }
-    ]
-  },
-  "footerSocials": {
-    "github": "https://github.com/trohitg/MachinaOs"
-  },
-  "feedback": {
-    "thumbsRating": true
-  },
-  "search": {
-    "prompt": "Search MachinaOs docs..."
-  }
-}

package/docs-MachinaOs/faq.mdx

@@ -1,309 +0,0 @@
----
-title: FAQ
-description: Frequently asked questions about MachinaOs
----
-
-# Frequently Asked Questions
-
-Common questions and troubleshooting for MachinaOs.
-
-## General
-
-<AccordionGroup>
-  <Accordion title="What is MachinaOs?">
-    MachinaOs is an open-source workflow automation platform inspired by n8n. It lets you create visual workflows that connect AI models, messaging services, devices, and APIs using a drag-and-drop interface.
-  </Accordion>
-
-  <Accordion title="Is MachinaOs free to use?">
-    Yes, MachinaOs is open-source and free to self-host. You only pay for external services you use (AI API calls, cloud hosting, etc.).
-  </Accordion>
-
-  <Accordion title="What's the difference between MachinaOs and n8n?">
-    MachinaOs is inspired by n8n's node-based approach but focuses on:
-    - Deep AI integration (OpenAI, Claude, Gemini with memory)
-    - WhatsApp automation
-    - Android device control
-    - Real-time WebSocket communication
-
-    MachinaOs is built with React and Python, while n8n uses Node.js.
-  </Accordion>
-
-  <Accordion title="Can I use MachinaOs commercially?">
-    Yes, MachinaOs is released under an open-source license. Check the repository for specific license terms.
-  </Accordion>
-</AccordionGroup>
-
-## Installation
-
-<AccordionGroup>
-  <Accordion title="What are the system requirements?">
-    **Minimum:**
-    - 2GB RAM
-    - 2 CPU cores
-    - 10GB disk space
-
-    **Recommended:**
-    - 4GB+ RAM
-    - 4+ CPU cores
-    - SSD storage
-  </Accordion>
-
-  <Accordion title="Can I run MachinaOs on Windows?">
-    Yes, using Docker Desktop for Windows or WSL2. Native development is also supported with Node.js and Python installed.
-  </Accordion>
-
-  <Accordion title="How do I update MachinaOs?">
-    ```bash
-    cd MachinaOs
-    git pull
-    docker-compose down
-    docker-compose up --build -d
-    ```
-  </Accordion>
-
-  <Accordion title="Port 3000 is already in use">
-    Change the port in your `.env` file:
-    ```
-    VITE_CLIENT_PORT=3001
-    ```
-    Then restart the services.
-  </Accordion>
-</AccordionGroup>
-
-## Workflows
-
-<AccordionGroup>
-  <Accordion title="What's the difference between Save and Deploy?">
-    - **Save**: Persists your workflow to the database. The workflow is not running.
-    - **Deploy**: Activates triggers and starts listening for events. Required for cron schedules, webhooks, and message triggers.
-  </Accordion>
-
-  <Accordion title="Why isn't my trigger node firing?">
-    1. Make sure the workflow is **deployed** (not just saved)
-    2. Check if filters are too restrictive
-    3. Verify external services are connected (WhatsApp, Android)
-    4. Check backend logs for errors
-  </Accordion>
-
-  <Accordion title="How do I pass data between nodes?">
-    Use template variables:
-    ```
-    {{nodeName.fieldName}}
-    ```
-    Example: `{{webhookTrigger.body.message}}`
-  </Accordion>
-
-  <Accordion title="Can I run multiple workflows simultaneously?">
-    Yes, each deployed workflow runs independently. Multiple workflows can have triggers active at the same time.
-  </Accordion>
-
-  <Accordion title="How do I debug a workflow?">
-    1. Use the **Run** button on individual nodes to test them
-    2. Check the output panel for node results
-    3. Add Python Executor nodes with `print()` statements
-    4. Check backend logs: `docker-compose logs -f backend`
-  </Accordion>
-</AccordionGroup>
-
-## AI Integration
-
-<AccordionGroup>
-  <Accordion title="Where do I add my API keys?">
-    Click the **key icon** in the toolbar to open the Credentials panel. Add keys for:
-    - OpenAI
-    - Anthropic (Claude)
-    - Google AI (Gemini)
-    - Google Maps
-    - Android Remote
-  </Accordion>
-
-  <Accordion title="Are my API keys secure?">
-    Yes, API keys are:
-    - Encrypted before storage
-    - Stored locally in SQLite
-    - Never sent to MachinaOs servers
-    - Only transmitted to the respective AI providers
-  </Accordion>
-
-  <Accordion title="How does conversation memory work?">
-    The Simple Memory node stores messages in SQLite by session ID. Connect it to an AI Agent's memory handle (diamond shape) to enable multi-turn conversations.
-  </Accordion>
-
-  <Accordion title="Which AI model should I use?">
-    | Use Case | Recommended |
-    |----------|-------------|
-    | General chat | GPT-4o, Claude 3.5 Sonnet |
-    | Complex reasoning | Claude 3 Opus, GPT-4 Turbo |
-    | Fast responses | GPT-3.5 Turbo, Claude Haiku |
-    | Long context | Gemini 1.5 Pro |
-    | Cost-effective | GPT-3.5 Turbo |
-  </Accordion>
-</AccordionGroup>
-
-## WhatsApp
-
-<AccordionGroup>
-  <Accordion title="How do I connect WhatsApp?">
-    1. Click the WhatsApp/Android icon in the toolbar
-    2. A QR code appears
-    3. Open WhatsApp on your phone
-    4. Go to Settings > Linked Devices > Link a Device
-    5. Scan the QR code
-  </Accordion>
-
-  <Accordion title="WhatsApp disconnects frequently">
-    - Ensure your phone has stable internet
-    - Don't use WhatsApp Web simultaneously
-    - Keep the MachinaOs server running continuously
-    - Check if you're logged out on your phone
-  </Accordion>
-
-  <Accordion title="Can I use WhatsApp Business?">
-    Yes, WhatsApp Business accounts work the same way as regular accounts.
-  </Accordion>
-
-  <Accordion title="How do I send to groups?">
-    Use the group's JID (ends with `@g.us`) as the recipient. The WhatsApp Receive node provides `group_info.group_jid` for incoming group messages.
-  </Accordion>
-</AccordionGroup>
-
-## Android
-
-<AccordionGroup>
-  <Accordion title="How do I connect an Android device?">
-    **Local (USB):**
-    1. Enable Developer Options and USB Debugging on your phone
-    2. Connect via USB
-    3. Run `adb devices` to verify
-    4. Select device in Android Device Setup node
-
-    **Remote:**
-    1. Configure relay URL in .env
-    2. Add API key in Credentials
-    3. Install companion app on device
-    4. Scan QR code to pair
-  </Accordion>
-
-  <Accordion title="ADB device not detected">
-    ```bash
-    # Check connection
-    adb devices
-
-    # Restart ADB
-    adb kill-server
-    adb start-server
-
-    # Try different USB cable/port
-    ```
-    Also ensure USB debugging is enabled in Developer Options.
-  </Accordion>
-
-  <Accordion title="Some actions require root access">
-    Some Android automation features require root or special permissions:
-    - Airplane mode toggle
-    - Some system settings
-    - Protected app access
-
-    Use automation apps like Tasker for restricted features.
-  </Accordion>
-</AccordionGroup>
-
-## Webhooks
-
-<AccordionGroup>
-  <Accordion title="What's my webhook URL?">
-    Local: `http://localhost:3010/webhook/{path}`
-    Production: `https://your-domain.com/webhook/{path}`
-
-    Replace `{path}` with the path you set in the Webhook Trigger node.
-  </Accordion>
-
-  <Accordion title="Webhook returns 404">
-    - Verify the workflow is **deployed**
-    - Check the path matches exactly (case-sensitive)
-    - Ensure backend is running on the correct port
-  </Accordion>
-
-  <Accordion title="How do I secure my webhooks?">
-    Use authentication in the Webhook Trigger node:
-    - Basic auth (username/password)
-    - Bearer token
-    - API key header
-  </Accordion>
-</AccordionGroup>
-
-## Deployment
-
-<AccordionGroup>
-  <Accordion title="Can I deploy without Docker?">
-    Yes, but it's more complex:
-    1. Install Node.js 18+ and Python 3.12+
-    2. Install dependencies: `npm install` and `pip install -r requirements.txt`
-    3. Build frontend: `npm run build`
-    4. Run backend: `uvicorn main:app`
-    5. Serve frontend with nginx
-
-    Docker is recommended for easier deployment.
-  </Accordion>
-
-  <Accordion title="How much does hosting cost?">
-    MachinaOs can run on a small VPS:
-    - DigitalOcean: ~$6/month (1GB RAM)
-    - AWS EC2: ~$10/month (t3.micro)
-    - Self-hosted: Hardware cost only
-
-    Plus costs for AI API calls and domain/SSL.
-  </Accordion>
-
-  <Accordion title="How do I backup my data?">
-    ```bash
-    # Backup SQLite database
-    docker cp machinaos-backend-1:/app/data ./backup/
-
-    # Backup WhatsApp session
-    docker cp machinaos-whatsapp-1:/app/data ./backup/whatsapp/
-    ```
-  </Accordion>
-</AccordionGroup>
-
-## Troubleshooting
-
-<AccordionGroup>
-  <Accordion title="Frontend shows blank page">
-    - Check browser console for errors
-    - Verify frontend container is running
-    - Clear browser cache
-    - Check if ports are blocked by firewall
-  </Accordion>
-
-  <Accordion title="WebSocket connection fails">
-    - Verify backend is running
-    - Check nginx WebSocket proxy configuration
-    - Ensure no firewall blocks WebSocket (port 3010)
-    - Check CORS settings in .env
-  </Accordion>
-
-  <Accordion title="High memory usage">
-    - Restart containers: `docker-compose restart`
-    - Check for runaway workflows
-    - Limit conversation memory window size
-    - Increase server RAM if needed
-  </Accordion>
-
-  <Accordion title="Database locked error">
-    SQLite doesn't handle concurrent writes well. If you see "database is locked":
-    - Restart backend container
-    - Consider migrating to PostgreSQL for production
-  </Accordion>
-</AccordionGroup>
-
-## Getting Help
-
-<CardGroup cols={2}>
-  <Card title="GitHub Issues" icon="github" href="https://github.com/trohitg/MachinaOs/issues">
-    Report bugs and request features
-  </Card>
-  <Card title="Documentation" icon="book" href="/introduction">
-    Browse the full documentation
-  </Card>
-</CardGroup>

package/docs-MachinaOs/favicon.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
-  <rect width="32" height="32" rx="6" fill="#16A34A"/>
-  <path d="M8 12h16M8 16h16M8 20h12" stroke="white" stroke-width="2" stroke-linecap="round"/>
-  <circle cx="24" cy="20" r="3" fill="white"/>
-</svg>

package/docs-MachinaOs/installation.mdx

@@ -1,160 +0,0 @@
----
-title: Installation
-description: Set up MachinaOs on your local machine or server
----
-
-# Installation
-
-MachinaOs can be installed using npm for development or Docker for production.
-
-## Prerequisites
-
-<Tabs>
-  <Tab title="Development">
-    - Node.js 18+
-    - Python 3.12+
-    - Git
-  </Tab>
-  <Tab title="Docker">
-    - Docker 20+
-    - Docker Compose 2+
-    - 2GB RAM minimum
-  </Tab>
-</Tabs>
-
-## Quick Install
-
-<Tabs>
-  <Tab title="npm (Development)">
-    ```bash
-    # Clone the repository
-    git clone https://github.com/trohitg/MachinaOS.git
-    cd MachinaOs
-
-    # Install dependencies
-    npm run build
-
-    # Start all services
-    npm run start
-    ```
-
-    The app will be available at:
-    - Frontend: `http://localhost:3000`
-    - Backend: `http://localhost:3010`
-    - WhatsApp: `http://localhost:9400`
-  </Tab>
-  <Tab title="Docker (Recommended)">
-    ```bash
-    # Clone the repository
-    git clone https://github.com/trohitg/MachinaOS.git
-    cd MachinaOs
-
-    # Build and start all services
-    npm run docker:build
-    npm run docker:up
-    ```
-
-    This starts 4 containers:
-    - **frontend** - React app (port 3000)
-    - **backend** - FastAPI server (port 3010)
-    - **whatsapp** - Go WhatsApp service (port 9400)
-    - **redis** - Cache (port 6379, when enabled)
-  </Tab>
-</Tabs>
-
-## Environment Configuration
-
-Copy the example environment file:
-
-```bash
-cp .env.example .env
-```
-
-### Key Settings
-
-<ParamField path="VITE_CLIENT_PORT" type="number" default="3000">
-  Frontend development server port
-</ParamField>
-
-<ParamField path="PYTHON_BACKEND_PORT" type="number" default="3010">
-  Backend API server port
-</ParamField>
-
-<ParamField path="AUTH_MODE" type="string" default="single">
-  Authentication mode: `single` (first user is owner) or `multi` (open registration)
-</ParamField>
-
-<ParamField path="REDIS_ENABLED" type="boolean" default="false">
-  Enable Redis cache. Set to `true` for production.
-</ParamField>
-
-<ParamField path="VITE_ANDROID_RELAY_URL" type="string">
-  WebSocket URL for remote Android device connections
-</ParamField>
-
-### Full Environment Example
-
-```bash
-# Ports
-VITE_CLIENT_PORT=3000
-PYTHON_BACKEND_PORT=3010
-
-# Authentication
-AUTH_MODE=single
-JWT_SECRET_KEY=your-secret-key-min-32-chars
-
-# Cache (production)
-REDIS_ENABLED=false
-REDIS_URL=redis://localhost:6379
-
-# Optional API Keys
-OPENAI_API_KEY=
-ANTHROPIC_API_KEY=
-GOOGLE_AI_API_KEY=
-GOOGLE_MAPS_API_KEY=
-```
-
-## Verify Installation
-
-1. Open `http://localhost:3000` in your browser
-2. You should see the MachinaOs workflow editor
-3. Check the backend health: `curl http://localhost:3010/health`
-
-<Check>
-If you see the workflow canvas with the component palette, installation is complete!
-</Check>
-
-## Troubleshooting
-
-<Accordion title="Port already in use">
-  Change the port in `.env`:
-  ```bash
-  VITE_CLIENT_PORT=3001
-  PYTHON_BACKEND_PORT=3011
-  ```
-</Accordion>
-
-<Accordion title="Python dependencies fail">
-  Create a virtual environment:
-  ```bash
-  cd server
-  python -m venv venv
-  source venv/bin/activate  # or venv\Scripts\activate on Windows
-  pip install -r requirements.txt
-  ```
-</Accordion>
-
-<Accordion title="Docker containers won't start">
-  Check logs and rebuild:
-  ```bash
-  docker-compose logs -f
-  docker-compose down
-  docker-compose up --build -d
-  ```
-</Accordion>
-
-## Next Steps
-
-<Card title="Quick Start" icon="rocket" href="/quickstart">
-  Build your first workflow in 5 minutes
-</Card>

package/docs-MachinaOs/introduction.mdx

@@ -1,114 +0,0 @@
----
-title: Introduction
-description: Visual workflow automation platform with AI agents, WhatsApp, and Android integration
----
-
-# 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.
-
-<CardGroup cols={2}>
-  <Card title="34 Nodes" icon="cube">
-    AI models, WhatsApp, Android automation, webhooks, code execution, and more
-  </Card>
-  <Card title="WebSocket-First" icon="bolt">
-    25 WebSocket message types for real-time status updates
-  </Card>
-  <Card title="AI-Powered" icon="brain">
-    OpenAI, Claude, Gemini with conversation memory and tool calling
-  </Card>
-  <Card title="Self-Hosted" icon="server">
-    Full control with Docker deployment and n8n-pattern caching
-  </Card>
-</CardGroup>
-
-## 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
-
-## Quick Links
-
-<CardGroup cols={2}>
-  <Card title="Installation" icon="download" href="/installation">
-    Get MachinaOs running locally in minutes
-  </Card>
-  <Card title="Quick Start" icon="rocket" href="/quickstart">
-    Build your first workflow in 5 minutes
-  </Card>
-  <Card title="Node Catalog" icon="grid" href="/nodes/overview">
-    Explore all 34 nodes
-  </Card>
-  <Card title="Tutorials" icon="graduation-cap" href="/tutorials/first-workflow">
-    Step-by-step guides
-  </Card>
-</CardGroup>
-
-## Architecture Overview
-
-MachinaOs follows n8n-inspired architectural patterns with modular backend services:
-
-| Layer | Technology |
-|-------|------------|
-| Frontend | React 19, TypeScript, React Flow, Zustand |
-| Backend | Python FastAPI, SQLAlchemy, LangChain |
-| Real-time | WebSocket (25 message handlers) |
-| WhatsApp | Go service with whatsmeow library |
-| Cache | Redis (production) / SQLite (dev) / Memory fallback |
-| Deployment | Docker 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
-```
-
-<Info>
-MachinaOs is designed for self-hosting. Your data stays on your infrastructure with automatic cache fallback for any environment.
-</Info>

package/docs-MachinaOs/logo/dark.svg

@@ -1,6 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 32" fill="none">
-  <rect width="32" height="32" rx="6" fill="#16A34A"/>
-  <path d="M8 12h16M8 16h16M8 20h12" stroke="white" stroke-width="2" stroke-linecap="round"/>
-  <circle cx="24" cy="20" r="3" fill="white"/>
-  <text x="40" y="22" font-family="system-ui, sans-serif" font-size="16" font-weight="600" fill="#ffffff">MachinaOs</text>
-</svg>

package/docs-MachinaOs/logo/light.svg

@@ -1,6 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 32" fill="none">
-  <rect width="32" height="32" rx="6" fill="#16A34A"/>
-  <path d="M8 12h16M8 16h16M8 20h12" stroke="white" stroke-width="2" stroke-linecap="round"/>
-  <circle cx="24" cy="20" r="3" fill="white"/>
-  <text x="40" y="22" font-family="system-ui, sans-serif" font-size="16" font-weight="600" fill="#1a1a1a">MachinaOs</text>
-</svg>