machinaos 0.0.8 → 0.0.10

package/.env.template

@@ -64,6 +64,10 @@ WEBSOCKET_API_KEY=
 # WhatsApp Service URL
 WHATSAPP_SERVICE_URL=http://localhost:5000
 
+# AI Proxy Configuration (Ollama-style proxy for Claude Code CLI)
+# Default port for AI proxy servers (e.g., Ollama, Claude Code CLI proxy)
+AI_PROXY_DEFAULT_PORT=11434
+
 # External API Keys (managed through UI, these are optional defaults)
 OPENAI_API_KEY=
 GOOGLE_MAPS_API_KEY=

package/README.md

@@ -1,10 +1,26 @@
 # MachinaOS
 
-Open-source workflow automation platform with AI agents, React Flow, and n8n-inspired architecture.
+Open-source Platform to Build Your Own Personal AI Assistant, mashup of clawdbot and n8n, but More Powerful.
+
+# Full Capabilities.
+
+<img width="1280" height="671" alt="func_img" src="https://github.com/user-attachments/assets/2f14b6c8-3995-4ccc-b076-e40749a83df2" />
+
+**60 nodes** | **6 AI providers** | **WebSocket-first** | **Self-hosted**
 
 ## Quick Start
 
-### Option 1: One-Line Install (Recommended)
+```bash
+npm install -g machinaos
+machinaos start
+```
+
+Open http://localhost:3000
+
+<details>
+<summary><b>Other Install Options</b></summary>
+
+### One-Line Install (installs all dependencies automatically)
 
 **Linux/macOS:**
 ```bash
@@ -16,9 +32,7 @@ curl -fsSL https://raw.githubusercontent.com/trohitg/MachinaOS/main/install.sh |
 iwr -useb https://raw.githubusercontent.com/trohitg/MachinaOS/main/install.ps1 | iex
 ```
 
-This automatically installs all dependencies (Node.js, Python, uv, Go) and MachinaOS.
-
-### Option 2: Clone & Run
+### Clone & Run
 
 ```bash
 git clone https://github.com/trohitg/MachinaOS.git
@@ -27,16 +41,7 @@ npm run build
 npm run start
 ```
 
-### Option 3: npm Global Install
-
-```bash
-npm install -g machinaos
-machinaos start
-```
-
-Requires Node.js 18+, Python 3.11+, uv, and Go 1.21+ to be pre-installed.
-
-### Option 4: Docker
+### Docker
 
 ```bash
 git clone https://github.com/trohitg/MachinaOS.git
@@ -44,7 +49,62 @@ cd MachinaOS
 npm run docker:up
 ```
 
-Open http://localhost:3000
+</details>
+
+## Features
+
+### AI Integration (6 Providers)
+
+| Provider | Models | Features |
+|----------|--------|----------|
+| **OpenAI** | GPT-4o, GPT-4 Turbo, o1, o3, o4-mini | JSON mode, reasoning effort |
+| **Anthropic** | Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku | Extended thinking |
+| **Google** | Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0 Flash Thinking | Multimodal, 1M context |
+| **OpenRouter** | 200+ models | Unified API for all providers |
+| **Groq** | Llama, Mixtral, Qwen | Ultra-fast inference |
+| **Cerebras** | Llama, Qwen | Ultra-fast on custom hardware |
+
+### AI Agents & Skills
+
+- **AI Agent** - LangGraph-powered with tool calling and iterative reasoning
+- **Chat Agent** - Conversational agent with skill support for multi-turn chat
+- **10 Skills** - WhatsApp, Maps, HTTP, Scheduler, Android, Code, Memory, Web Search, Custom
+- **4 Tools** - Calculator, Current Time, Web Search, Android Toolkit
+- **Simple Memory** - Markdown-based conversation history with vector storage
+
+### Platform Integrations
+
+- **WhatsApp** - Send/receive messages with QR pairing, filters, group support
+- **Android** - 17 service nodes for device control (battery, WiFi, Bluetooth, apps, camera, sensors)
+- **HTTP/Webhooks** - REST API integration with event-driven triggers
+- **Google Maps** - Geocoding, nearby places, directions
+
+### Document Processing (RAG Pipeline)
+
+- **HTTP Scraper** - Scrape URLs with pagination and date ranges
+- **File Downloader** - Parallel downloads with semaphore concurrency
+- **Document Parser** - PyPDF, Marker (OCR), Unstructured, BeautifulSoup
+- **Text Chunker** - Recursive, markdown, or token-based splitting
+- **Embedding Generator** - HuggingFace, OpenAI, Ollama embeddings
+- **Vector Store** - ChromaDB, Qdrant, Pinecone backends
+
+## Node Categories
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| AI Models | 6 | OpenAI, Anthropic, Google, OpenRouter, Groq, Cerebras |
+| AI Agents | 3 | AI Agent, Chat Agent, Simple Memory |
+| AI Skills | 10 | WhatsApp, Maps, HTTP, Scheduler, Android, Code, etc. |
+| AI Tools | 4 | Calculator, Time, Search, Android Toolkit |
+| WhatsApp | 3 | Send, Receive, Database |
+| Android | 17 | Device control and monitoring |
+| Documents | 6 | RAG pipeline nodes |
+| Utilities | 5 | HTTP, Webhooks, Chat Trigger, Console |
+| Location | 3 | Google Maps integration |
+| Code | 2 | Python and JavaScript executors |
+| Workflow | 1 | Start node |
+
+**Total: 60 nodes**
 
 ## Prerequisites
 
@@ -67,26 +127,6 @@ The install script handles these automatically, but for manual installation:
 | `machinaos docker:down` | Stop Docker containers |
 | `machinaos help` | Show all available commands |
 
-## Local Development
-
-```bash
-git clone https://github.com/trohitg/MachinaOS.git
-cd MachinaOS
-npm run build
-npm run start
-```
-
----
-
-## Features
-
-- **AI Workflows** - OpenAI, Claude, Gemini, Groq, OpenRouter models with tool calling
-- **AI Agents** - LangGraph-powered agents with memory and skills
-- **Android Automation** - Control your phone via 17 service nodes
-- **WhatsApp Bots** - Send/receive messages with filters and triggers
-- **HTTP/Webhooks** - API integrations with event-driven triggers
-- **Document Processing** - RAG pipeline with vector storage
-
 ## Configuration
 
 **API Keys:** Click **Credentials** button in toolbar to add API keys for OpenAI, Claude, Google Maps, etc.
@@ -131,6 +171,16 @@ MachinaOS/
 - **Services:** WhatsApp (Go + whatsmeow), WebSocket relay
 - **Package Manager:** uv (Python), npm (Node.js)
 
+## Documentation
+
+Full documentation available at: https://docs.machinaos.dev
+
+- [Installation Guide](https://docs.machinaos.dev/installation)
+- [Quick Start](https://docs.machinaos.dev/quickstart)
+- [Node Catalog](https://docs.machinaos.dev/nodes/overview)
+- [AI Models](https://docs.machinaos.dev/nodes/ai-models)
+- [AI Agents](https://docs.machinaos.dev/nodes/ai-agent)
+
 ## Troubleshooting
 
 **Port already in use:**

package/bin/cli.js

@@ -44,14 +44,31 @@ function getVersion(cmd) {
   }
 }
 
+// Add common binary paths to PATH (Linux installs uv to ~/.local/bin)
+function expandPath() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (home) {
+    const additionalPaths = [
+      `${home}/.local/bin`,      // uv, cargo installs
+      `${home}/.cargo/bin`,      // Rust tools
+      '/usr/local/bin',          // Homebrew on macOS
+    ];
+    const currentPath = process.env.PATH || '';
+    const sep = process.platform === 'win32' ? ';' : ':';
+    const newPaths = additionalPaths.filter(p => !currentPath.includes(p));
+    if (newPaths.length > 0) {
+      process.env.PATH = newPaths.join(sep) + sep + currentPath;
+    }
+  }
+}
+
 function checkDeps() {
   const errors = [];
-  const warnings = [];
 
   // Node.js version check
   const nodeVersion = parseInt(process.version.slice(1));
-  if (nodeVersion < 18) {
-    errors.push(`Node.js 18+ required (found ${process.version})`);
+  if (nodeVersion < 20) {
+    errors.push(`Node.js 20+ required (found ${process.version})`);
   }
 
   // Python version check
@@ -73,15 +90,6 @@ function checkDeps() {
     errors.push('uv (Python package manager) - https://docs.astral.sh/uv/');
   }
 
-  // Go check (warning only - needed for WhatsApp service)
-  if (!getVersion('go version')) {
-    warnings.push('Go 1.21+ (optional, for WhatsApp service) - https://go.dev/dl/');
-  }
-
-  if (warnings.length > 0) {
-    console.warn('Warnings:\n' + warnings.map(w => `  - ${w}`).join('\n') + '\n');
-  }
-
   if (errors.length > 0) {
     console.error('Missing required dependencies:\n' + errors.map(e => `  - ${e}`).join('\n'));
     console.error('\nInstall the missing dependencies and try again.');
@@ -99,6 +107,9 @@ function run(script) {
   child.on('close', (code) => process.exit(code || 0));
 }
 
+// Expand PATH to find tools like uv installed in user directories
+expandPath();
+
 const cmd = process.argv[2] || 'help';
 
 if (cmd === 'help' || cmd === '--help' || cmd === '-h') {

package/client/Dockerfile

@@ -5,10 +5,10 @@ FROM node:22-alpine AS development
 WORKDIR /app
 
 # Copy package files
-COPY package.json package-lock.json* ./
+COPY package.json ./
 
-# Install dependencies (npm ci for faster, deterministic installs)
-RUN npm ci
+# Install dependencies
+RUN npm install
 
 # Copy application code
 COPY . .
@@ -28,10 +28,10 @@ FROM node:22-alpine AS builder
 WORKDIR /app
 
 # Copy package files
-COPY package.json package-lock.json* ./
+COPY package.json ./
 
-# Install dependencies (npm ci for faster, deterministic installs)
-RUN npm ci
+# Install dependencies
+RUN npm install
 
 # Copy application code
 COPY . .
@@ -41,12 +41,14 @@ ARG VITE_AUTH_ENABLED=true
 ARG VITE_PYTHON_SERVICE_URL=
 ARG VITE_WHATSAPP_SERVICE_URL=
 ARG VITE_ANDROID_RELAY_URL=
+ARG VITE_APP_VERSION=0.0.0
 
 # Expose build args as environment variables for Vite build
 ENV VITE_AUTH_ENABLED=$VITE_AUTH_ENABLED
 ENV VITE_PYTHON_SERVICE_URL=$VITE_PYTHON_SERVICE_URL
 ENV VITE_WHATSAPP_SERVICE_URL=$VITE_WHATSAPP_SERVICE_URL
 ENV VITE_ANDROID_RELAY_URL=$VITE_ANDROID_RELAY_URL
+ENV VITE_APP_VERSION=$VITE_APP_VERSION
 
 # Increase Node.js memory limit for large builds (GCP e2-micro has limited RAM)
 ENV NODE_OPTIONS="--max-old-space-size=2048"

package/client/src/Dashboard.tsx

@@ -27,8 +27,10 @@ import { CHAT_NODE_TYPES } from './nodeDefinitions/chatNodes';
 import { CODE_NODE_TYPES } from './nodeDefinitions/codeNodes';
 import { UTILITY_NODE_TYPES } from './nodeDefinitions/utilityNodes';
 import { TOOL_NODE_TYPES } from './nodeDefinitions/toolNodes';
+import { SPECIALIZED_AGENT_TYPES } from './nodeDefinitions/specializedAgentNodes';
 import { SKILL_NODE_TYPES } from './nodeDefinitions/skillNodes';
 import { DOCUMENT_NODE_TYPES } from './nodeDefinitions/documentNodes';
+import { SOCIAL_NODE_TYPES } from './nodeDefinitions/socialNodes';
 import ParameterPanel from './ParameterPanel';
 import LocationParameterPanel from './components/LocationParameterPanel';
 import { useAppStore } from './store/useAppStore';
@@ -65,6 +67,12 @@ const createNodeTypes = (): Record<string, React.ComponentType<any>> => {
   // Trigger nodes (no input handles) - check by group or specific types
   const TRIGGER_NODE_TYPES = ['start', 'cronScheduler', 'webhookTrigger', 'whatsappReceive', 'chatTrigger'];
 
+  // Pre-register specialized agent nodes explicitly to ensure they're always available
+  // This handles cases where nodeDefinitions iteration order might miss them
+  SPECIALIZED_AGENT_TYPES.forEach(type => {
+    types[type] = AIAgentNode;
+  });
+
   Object.keys(nodeDefinitions).forEach(type => {
     const definition = nodeDefinitions[type];
 
@@ -98,20 +106,20 @@ const createNodeTypes = (): Record<string, React.ComponentType<any>> => {
       // Utility nodes (HTTP, Webhooks) use SquareNode component
       // Note: webhookTrigger is already handled as trigger above
       types[type] = SquareNode;
+    } else if (SPECIALIZED_AGENT_TYPES.includes(type)) {
+      // Specialized agent nodes use AIAgentNode (rectangular card with bottom handles)
+      types[type] = AIAgentNode;
     } else if (TOOL_NODE_TYPES.includes(type)) {
-      // Most tool nodes use circular ModelNode
-      // Exception: androidTool uses ToolkitNode with top/bottom handles
-      if (type === 'androidTool') {
-        types[type] = ToolkitNode;
-      } else {
-        types[type] = ModelNode;
-      }
+      types[type] = SquareNode;
     } else if (SKILL_NODE_TYPES.includes(type)) {
       // Skill nodes use ToolkitNode (vertical handle layout like Android Toolkit)
       types[type] = ToolkitNode;
     } else if (DOCUMENT_NODE_TYPES.includes(type)) {
       // Document processing nodes use SquareNode component
       types[type] = SquareNode;
+    } else if (SOCIAL_NODE_TYPES.includes(type)) {
+      // Social nodes use AIAgentNode for multiple output handles support
+      types[type] = AIAgentNode;
     } else if (definition?.group?.includes('model')) {
       // Fallback for other model nodes
       types[type] = ModelNode;
@@ -293,7 +301,8 @@ const DashboardContent: React.FC = () => {
   } = useWorkflowManagement();
 
   const { collapsedSections, searchQuery, setSearchQuery, toggleSection } = useComponentPalette();
-  const { saveNodeParameters, executeWorkflow, deployWorkflow, cancelDeployment, nodeStatuses, deploymentStatus, workflowLock } = useWebSocket();
+  const { saveNodeParameters, executeWorkflow, deployWorkflow, cancelDeployment, nodeStatuses, deploymentStatus, workflowLock, isConnected, sendRequest } = useWebSocket();
+  const applyUIDefaults = useAppStore((state) => state.applyUIDefaults);
 
   // Scope deployment and lock to current workflow (n8n pattern)
   // Only show as "running" or "locked" if it applies to the currently viewed workflow
@@ -334,7 +343,10 @@ const DashboardContent: React.FC = () => {
   });
   const [settingsOpen, setSettingsOpen] = React.useState(false);
   const [credentialsOpen, setCredentialsOpen] = React.useState(false);
-  const [consolePanelOpen, setConsolePanelOpen] = React.useState(false);
+
+  // Console panel visibility from store (database-backed)
+  const consolePanelVisible = useAppStore((state) => state.consolePanelVisible);
+  const toggleConsolePanelVisible = useAppStore((state) => state.toggleConsolePanelVisible);
 
   // Context menu state for node right-click
   const [contextMenu, setContextMenu] = React.useState<{
@@ -348,6 +360,40 @@ const DashboardContent: React.FC = () => {
     localStorage.setItem('workflow_settings', JSON.stringify(settings));
   }, [settings]);
 
+  // Load UI defaults from database on initial WebSocket connection
+  const hasLoadedUIDefaults = React.useRef(false);
+  React.useEffect(() => {
+    if (!isConnected || hasLoadedUIDefaults.current) return;
+    hasLoadedUIDefaults.current = true;
+
+    const loadUIDefaults = async () => {
+      try {
+        const response = await sendRequest<{ settings: any }>('get_user_settings', {});
+        if (response?.settings) {
+          applyUIDefaults({
+            sidebarDefaultOpen: response.settings.sidebar_default_open,
+            componentPaletteDefaultOpen: response.settings.component_palette_default_open,
+            consolePanelDefaultOpen: response.settings.console_panel_default_open,
+          });
+          // Also update local settings state for auto-save preferences
+          setSettings(prev => ({
+            ...prev,
+            autoSave: response.settings.auto_save ?? prev.autoSave,
+            autoSaveInterval: response.settings.auto_save_interval ?? prev.autoSaveInterval,
+            sidebarDefaultOpen: response.settings.sidebar_default_open ?? prev.sidebarDefaultOpen,
+            componentPaletteDefaultOpen: response.settings.component_palette_default_open ?? prev.componentPaletteDefaultOpen,
+            consolePanelDefaultOpen: response.settings.console_panel_default_open ?? prev.consolePanelDefaultOpen,
+          }));
+          console.log('[Dashboard] UI defaults loaded from database');
+        }
+      } catch (error) {
+        console.error('[Dashboard] Failed to load UI defaults:', error);
+      }
+    };
+
+    loadUIDefaults();
+  }, [isConnected, sendRequest, applyUIDefaults]);
+
   // Update nodes with execution status classes
   const styledNodes = React.useMemo(() => {
     return nodes.map(node => {
@@ -1140,8 +1186,8 @@ const DashboardContent: React.FC = () => {
 
         {/* Console Panel - n8n-style debug output at bottom */}
         <ConsolePanel
-          isOpen={consolePanelOpen}
-          onToggle={() => setConsolePanelOpen(prev => !prev)}
+          isOpen={consolePanelVisible}
+          onToggle={toggleConsolePanelVisible}
           nodes={nodes}
         />