machinaos 0.0.1 → 0.0.6

package/.env.template

@@ -1,71 +1,71 @@
-# Service Ports (used by start.js, vite, and docker-compose)
-VITE_CLIENT_PORT=3000
-PYTHON_BACKEND_PORT=3010
-WHATSAPP_RPC_PORT=9400
-REDIS_PORT=6379
-
-# Server Configuration
-HOST=127.0.0.1
-PORT=3010
-DEBUG=false
-WORKERS=1
-
-# Security (Development keys - MUST CHANGE FOR PRODUCTION)
-SECRET_KEY=dev-secret-key-12345678901234567890123456789012
-API_KEY_ENCRYPTION_KEY=dev-encryption-key-12345678901234567890123456
-
-# Authentication
-# VITE_AUTH_ENABLED: "true" (require login) or "false" (bypass authentication)
-VITE_AUTH_ENABLED=false
-# AUTH_MODE: "single" (local deploy - first user is owner) or "multi" (cloud - open registration)
-AUTH_MODE=single
-JWT_SECRET_KEY=dev-jwt-secret-key-12345678901234567890
-JWT_EXPIRE_MINUTES=10080
-JWT_COOKIE_NAME=machina_token
-JWT_COOKIE_SECURE=false
-JWT_COOKIE_SAMESITE=lax
-
-# CORS Configuration - Allow all common dev ports
-CORS_ORIGINS=["http://localhost:3000","http://localhost:3001","http://localhost:3002","http://localhost:3003","http://localhost:3004","http://localhost:3005","http://localhost:3006","http://127.0.0.1:3000","http://127.0.0.1:3001","http://127.0.0.1:3002","http://127.0.0.1:3003","http://127.0.0.1:3004","http://127.0.0.1:3005","http://127.0.0.1:3006","http://localhost:5173"]
-
-# Database Configuration
-DATABASE_URL=sqlite+aiosqlite:///./data/workflow.db
-DATABASE_ECHO=false
-DATABASE_POOL_SIZE=5
-DATABASE_MAX_OVERFLOW=10
-
-# Cache Configuration (Disabled for development)
-REDIS_ENABLED=false
-CACHE_TTL=300
-
-# Logging
-LOG_LEVEL=INFO
-LOG_FORMAT=text
-
-# Rate Limiting (Relaxed for development)
-RATE_LIMIT_ENABLED=false
-RATE_LIMIT_REQUESTS=1000
-RATE_LIMIT_WINDOW=60
-
-# Service Timeouts (Extended for debugging)
-AI_TIMEOUT=60
-AI_MAX_RETRIES=1
-AI_RETRY_DELAY=0.5
-
-MAPS_TIMEOUT=30
-
-# Health Check
-HEALTH_CHECK_INTERVAL=60
-
-# WebSocket Configuration (For remote Android device connections)
-WEBSOCKET_URL=
-WEBSOCKET_API_KEY=
-
-# WhatsApp Service URL
-WHATSAPP_SERVICE_URL=http://localhost:5000
-
-# External API Keys (managed through UI, these are optional defaults)
-OPENAI_API_KEY=
-GOOGLE_MAPS_API_KEY=
-ANTHROPIC_API_KEY=
-GOOGLE_AI_API_KEY=
+# Service Ports (used by start.js, vite, and docker-compose)
+VITE_CLIENT_PORT=3000
+PYTHON_BACKEND_PORT=3010
+WHATSAPP_RPC_PORT=9400
+REDIS_PORT=6379
+
+# Server Configuration
+HOST=127.0.0.1
+PORT=3010
+DEBUG=false
+WORKERS=1
+
+# Security (Development keys - MUST CHANGE FOR PRODUCTION)
+SECRET_KEY=dev-secret-key-12345678901234567890123456789012
+API_KEY_ENCRYPTION_KEY=dev-encryption-key-12345678901234567890123456
+
+# Authentication
+# VITE_AUTH_ENABLED: "true" (require login) or "false" (bypass authentication)
+VITE_AUTH_ENABLED=false
+# AUTH_MODE: "single" (local deploy - first user is owner) or "multi" (cloud - open registration)
+AUTH_MODE=single
+JWT_SECRET_KEY=dev-jwt-secret-key-12345678901234567890
+JWT_EXPIRE_MINUTES=10080
+JWT_COOKIE_NAME=machina_token
+JWT_COOKIE_SECURE=false
+JWT_COOKIE_SAMESITE=lax
+
+# CORS Configuration - Allow all common dev ports
+CORS_ORIGINS=["http://localhost:3000","http://localhost:3001","http://localhost:3002","http://localhost:3003","http://localhost:3004","http://localhost:3005","http://localhost:3006","http://127.0.0.1:3000","http://127.0.0.1:3001","http://127.0.0.1:3002","http://127.0.0.1:3003","http://127.0.0.1:3004","http://127.0.0.1:3005","http://127.0.0.1:3006","http://localhost:5173"]
+
+# Database Configuration
+DATABASE_URL=sqlite+aiosqlite:///./data/workflow.db
+DATABASE_ECHO=false
+DATABASE_POOL_SIZE=5
+DATABASE_MAX_OVERFLOW=10
+
+# Cache Configuration (Disabled for development)
+REDIS_ENABLED=false
+CACHE_TTL=300
+
+# Logging
+LOG_LEVEL=INFO
+LOG_FORMAT=text
+
+# Rate Limiting (Relaxed for development)
+RATE_LIMIT_ENABLED=false
+RATE_LIMIT_REQUESTS=1000
+RATE_LIMIT_WINDOW=60
+
+# Service Timeouts (Extended for debugging)
+AI_TIMEOUT=60
+AI_MAX_RETRIES=1
+AI_RETRY_DELAY=0.5
+
+MAPS_TIMEOUT=30
+
+# Health Check
+HEALTH_CHECK_INTERVAL=60
+
+# WebSocket Configuration (For remote Android device connections)
+WEBSOCKET_URL=
+WEBSOCKET_API_KEY=
+
+# WhatsApp Service URL
+WHATSAPP_SERVICE_URL=http://localhost:5000
+
+# External API Keys (managed through UI, these are optional defaults)
+OPENAI_API_KEY=
+GOOGLE_MAPS_API_KEY=
+ANTHROPIC_API_KEY=
+GOOGLE_AI_API_KEY=

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 MachinaOs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 MachinaOs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,87 +1,145 @@
-# MachinaOs
-
- Platform to Build Personal AI Assistants for Yourself that Perform Human Like Tasks.
- mashup of N8N + Clawdbot 
-
-## Quick Start
-
-```bash
-git clone https://github.com/trohitg/MachinaOS.git
-cd MachinaOs
-npm run docker:build
-npm run docker:up
-```
-
-Open http://localhost:3000
-
-## Local Development
-
-**Prerequisites:** Node.js 18+, Python 3.10+, Go 1.21+
-
-```bash
-npm run build
-npm run start
-```
-
----
-
-## Features
-
-- **AI Workflows** - OpenAI, Claude, Gemini models with tool calling
-- **Android Automation** - Control your phone via 17 service nodes
-- **WhatsApp Bots** - Send/receive messages with filters
-- **HTTP/Webhooks** - API integrations
-- **Tool Schema Editor** - Customize AI tool schemas per service
-
-## Docker Commands
-
-### Development (hot reload, larger images)
-| Command | Description |
-|---------|-------------|
-| `npm run docker:build` | Build dev images |
-| `npm run docker:up` | Start dev containers |
-| `npm run docker:down` | Stop containers |
-| `npm run docker:logs` | View logs |
-
-### Production (optimized, smaller images)
-| Command | Description |
-|---------|-------------|
-| `npm run docker:prod:build` | Build prod images |
-| `npm run docker:prod:up` | Start prod containers |
-| `npm run docker:prod:logs` | View logs |
-
-**Redis (optional):** Set `REDIS_ENABLED=true` in `.env`
-
-## Local Commands
-
-| Command | Description |
-|---------|-------------|
-| `npm run start` | Start all services |
-| `npm run stop` | Stop all services |
-| `npm run build` | Install dependencies |
-
-## Configuration
-
-**API Keys:** Click **Credentials** button in toolbar to add API keys for OpenAI, Claude, Google Maps, etc.
-
-**Environment:** Edit `.env` for auth settings, ports, and database location.
-
-## Project Structure
-
-```
-MachinaOs/
-├── client/          # React frontend (localhost:3000)
-├── server/          # Python backend (localhost:3010)
-│   └── whatsapp-rpc/  # WhatsApp service
-└── package.json
-```
-
-## Tech Stack
-
-- **Frontend:** React, TypeScript, React Flow
-- **Backend:** Python, FastAPI, SQLite
-- **Services:** WhatsApp (Go), WebSocket relay
-
-## License
-
-MIT
+# MachinaOS
+
+Open-source workflow automation platform with AI agents, React Flow, and n8n-inspired architecture.
+
+## Quick Start
+
+### Option 1: Clone & Run
+
+```bash
+git clone https://github.com/trohitg/MachinaOS.git
+cd MachinaOS
+npm run build
+npm run start
+```
+
+### Option 2: Global Install
+
+```bash
+npm install -g machinaos
+machinaos start
+```
+
+### Option 3: Docker
+
+```bash
+git clone https://github.com/trohitg/MachinaOS.git
+cd MachinaOS
+npm run docker:up
+```
+
+Open http://localhost:3000
+
+## Prerequisites
+
+- **Node.js 18+** - https://nodejs.org/
+- **Python 3.11+** - https://python.org/
+- **uv** - `curl -LsSf https://astral.sh/uv/install.sh | sh`
+- **Go 1.21+** - https://go.dev/dl/ (for WhatsApp service)
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `machinaos start` | Start all services (frontend, backend, WhatsApp) |
+| `machinaos stop` | Stop all running services |
+| `machinaos build` | Build for production |
+| `machinaos clean` | Remove build artifacts and dependencies |
+| `machinaos docker:up` | Start with Docker Compose |
+| `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.
+
+**Environment:** Copy `.env.template` to `.env` and customize ports, auth settings, database location.
+
+## Docker Commands
+
+| Command | Description |
+|---------|-------------|
+| `machinaos docker:up` | Start containers (detached) |
+| `machinaos docker:down` | Stop containers |
+| `machinaos docker:build` | Rebuild images |
+| `machinaos docker:logs` | View logs (follows) |
+
+**Redis (optional):** Set `REDIS_ENABLED=true` in `.env`
+
+### Production Docker
+
+```bash
+npm run docker:prod:build
+npm run docker:prod:up
+```
+
+## Project Structure
+
+```
+MachinaOS/
+├── client/           # React frontend (localhost:3000)
+├── server/           # Python FastAPI backend (localhost:3010)
+│   ├── services/     # Workflow execution, AI, handlers
+│   ├── routers/      # API endpoints, WebSocket
+│   └── whatsapp-rpc/ # WhatsApp Go service
+├── scripts/          # Cross-platform Node.js scripts
+└── bin/cli.js        # CLI entry point
+```
+
+## Tech Stack
+
+- **Frontend:** React 19, TypeScript, React Flow, Zustand
+- **Backend:** Python 3.11+, FastAPI, SQLite, LangChain/LangGraph
+- **Services:** WhatsApp (Go + whatsmeow), WebSocket relay
+- **Package Manager:** uv (Python), npm (Node.js)
+
+## Troubleshooting
+
+**Port already in use:**
+```bash
+machinaos stop   # Kill all services
+machinaos start  # Restart
+```
+
+**Missing dependencies:**
+```bash
+machinaos build  # Install all dependencies
+```
+
+**Clean install:**
+```bash
+machinaos clean  # Remove node_modules, .venv, dist
+machinaos build  # Reinstall everything
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests and linting
+5. Submit a pull request
+
+## License
+
+MIT

package/bin/cli.js

@@ -1,22 +1,20 @@
 #!/usr/bin/env node
 
 import { spawn, execSync } from 'child_process';
-import { existsSync, copyFileSync } from 'fs';
-import { resolve, dirname } from 'path';
+import { dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const ROOT_DIR = resolve(__dirname, '..');
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 
 const COMMANDS = {
   start: 'Start the development server',
   stop: 'Stop all running services',
   build: 'Build the project for production',
+  clean: 'Clean build artifacts',
   'docker:up': 'Start with Docker Compose',
   'docker:down': 'Stop Docker Compose services',
+  'docker:build': 'Build Docker images',
   'docker:logs': 'View Docker logs',
-  init: 'Initialize environment file from template',
   help: 'Show this help message',
 };
 
@@ -27,133 +25,91 @@ MachinaOS - Workflow Automation Platform
 Usage: machinaos <command>
 
 Commands:
-${Object.entries(COMMANDS)
-    .map(([cmd, desc]) => `  ${cmd.padEnd(14)} ${desc}`)
-    .join('\n')}
+${Object.entries(COMMANDS).map(([cmd, desc]) => `  ${cmd.padEnd(14)} ${desc}`).join('\n')}
 
 Examples:
-  machinaos init       # Create .env from template
   machinaos start      # Start development server
+  machinaos build      # Build for production
   machinaos docker:up  # Start with Docker
 
 Documentation: https://github.com/trohitg/MachinaOS
 `);
 }
 
-function checkDependencies() {
-  const missing = [];
-
-  // Check Node.js version
-  const nodeVersion = process.version.slice(1).split('.')[0];
-  if (parseInt(nodeVersion) < 18) {
-    console.error(`Error: Node.js 18+ required (found ${process.version})`);
-    process.exit(1);
-  }
-
-  // Check Python
+function getVersion(cmd) {
   try {
-    execSync('python --version', { stdio: 'pipe' });
+    return execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
   } catch {
-    missing.push('Python 3.11+');
+    return null;
   }
+}
 
-  // Check uv (Python package manager)
-  try {
-    execSync('uv --version', { stdio: 'pipe' });
-  } catch {
-    missing.push('uv (install: curl -LsSf https://astral.sh/uv/install.sh | sh)');
+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 (missing.length > 0) {
-    console.error('Missing dependencies:');
-    missing.forEach((dep) => console.error(`  - ${dep}`));
-    console.error('\nPlease install the missing dependencies and try again.');
-    process.exit(1);
+  // Python version check
+  let pyVersion = getVersion('python --version') || getVersion('python3 --version');
+  if (!pyVersion) {
+    errors.push('Python 3.11+ - https://python.org/');
+  } else {
+    const match = pyVersion.match(/Python (\d+)\.(\d+)/);
+    if (match) {
+      const [, major, minor] = match.map(Number);
+      if (major < 3 || (major === 3 && minor < 11)) {
+        errors.push(`Python 3.11+ required (found ${pyVersion})`);
+      }
+    }
   }
-}
 
-function initEnv() {
-  const envPath = resolve(ROOT_DIR, 'server', '.env');
-  const templatePath = resolve(ROOT_DIR, '.env.template');
+  // uv package manager check
+  if (!getVersion('uv --version')) {
+    errors.push('uv (Python package manager) - https://docs.astral.sh/uv/');
+  }
 
-  if (existsSync(envPath)) {
-    console.log('.env file already exists at server/.env');
-    return;
+  // 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 (!existsSync(templatePath)) {
-    console.error('Error: .env.template not found');
-    process.exit(1);
+  if (warnings.length > 0) {
+    console.warn('Warnings:\n' + warnings.map(w => `  - ${w}`).join('\n') + '\n');
   }
 
-  copyFileSync(templatePath, envPath);
-  console.log('Created server/.env from template');
-  console.log('Edit server/.env to configure your API keys and settings');
+  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.');
+    process.exit(1);
+  }
 }
 
-function runNpmScript(script) {
-  const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const child = spawn(npm, ['run', script], {
-    cwd: ROOT_DIR,
+function run(script) {
+  const child = spawn(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['run', script], {
+    cwd: ROOT,
     stdio: 'inherit',
     shell: true,
   });
-
-  child.on('error', (err) => {
-    console.error(`Failed to run: ${err.message}`);
-    process.exit(1);
-  });
-
-  child.on('close', (code) => {
-    process.exit(code || 0);
-  });
+  child.on('error', (e) => { console.error(`Failed: ${e.message}`); process.exit(1); });
+  child.on('close', (code) => process.exit(code || 0));
 }
 
-// Main
-const [, , command = 'help'] = process.argv;
-
-switch (command) {
-  case 'help':
-  case '--help':
-  case '-h':
-    printHelp();
-    break;
-
-  case 'init':
-    initEnv();
-    break;
-
-  case 'start':
-    checkDependencies();
-    if (!existsSync(resolve(ROOT_DIR, 'server', '.env'))) {
-      console.log('No .env found. Running init first...');
-      initEnv();
-    }
-    runNpmScript('start');
-    break;
-
-  case 'stop':
-    runNpmScript('stop');
-    break;
-
-  case 'build':
-    runNpmScript('build');
-    break;
-
-  case 'docker:up':
-    runNpmScript('docker:up');
-    break;
-
-  case 'docker:down':
-    runNpmScript('docker:down');
-    break;
-
-  case 'docker:logs':
-    runNpmScript('docker:logs');
-    break;
-
-  default:
-    console.error(`Unknown command: ${command}`);
-    printHelp();
-    process.exit(1);
+const cmd = process.argv[2] || 'help';
+
+if (cmd === 'help' || cmd === '--help' || cmd === '-h') {
+  printHelp();
+} else if (cmd === 'start' || cmd === 'build') {
+  checkDeps();
+  run(cmd);
+} else if (COMMANDS[cmd]) {
+  run(cmd);
+} else {
+  console.error(`Unknown command: ${cmd}`);
+  printHelp();
+  process.exit(1);
 }