Skip to content

Self-improving AI Employees for everyone

fix: CI workflow improvements and WhatsApp binary download

trohitg8065e2e90c6a
diff --git a/.github/workflows/predeploy.yml b/.github/workflows/predeploy.yml
index aaeb50c1..6c3d3287 100644
--- a/.github/workflows/predeploy.yml
+++ b/.github/workflows/predeploy.yml
@@ -72,11 +72,22 @@ jobs:
- name: Checkout
uses: actions/checkout@v4
+ - name: Set up Docker Buildx
+ uses: docker/setup-buildx-action@v3
+ with:
+ driver-opts: network=host
+
- name: Create .env from template
run: cp .env.template .env
- - name: Build with Docker Compose
- run: docker compose -f docker-compose.prod.yml build
+ - name: Build with cache (reuses docker-build cache)
+ run: |
+ docker buildx build --load --cache-from type=gha \
+ -t machinaos-frontend:latest -f client/Dockerfile --target production client
+ docker buildx build --load --cache-from type=gha \
+ -t machinaos-backend:latest -f server/Dockerfile server
+ docker buildx build --load --cache-from type=gha \
+ -t machinaos-whatsapp:latest -f docker/Dockerfile.whatsapp docker
- name: Start services
run: docker compose -f docker-compose.prod.yml up -d
@@ -105,7 +116,37 @@ jobs:
if: always()
run: docker compose -f docker-compose.prod.yml down -v
+ # Build client once on Ubuntu, upload as artifact for test-install jobs
+ build-client:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup environment
+ uses: ./.github/actions/setup
+
+ - name: Install and build client
+ run: |
+ cd client
+ npm install
+ npm run build
+
+ - name: Pack npm package with pre-built client
+ env:
+ CI: false
+ GITHUB_ACTIONS: false
+ run: npm pack
+
+ - name: Upload package artifact
+ uses: actions/upload-artifact@v4
+ with:
+ name: npm-package
+ path: machinaos-*.tgz
+ retention-days: 1
+
test-install:
+ needs: build-client
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
@@ -115,26 +156,31 @@ jobs:
- name: Checkout
uses: actions/checkout@v4
- # Python and uv needed because postinstall.js skips in CI
- name: Setup environment
uses: ./.github/actions/setup
- - name: Install root dependencies
- run: npm install --ignore-scripts
-
- - name: Pack npm package
- run: npm pack
+ - name: Download package artifact
+ uses: actions/download-artifact@v4
+ with:
+ name: npm-package
- name: Test global install
shell: bash
+ env:
+ CI: false
+ GITHUB_ACTIONS: false
run: |
npm install -g machinaos-*.tgz
machinaos --help
machinaos --version
- - name: Build (install client deps, build client, setup Python venv)
+ - name: Setup Python venv only
shell: bash
- run: machinaos build
+ run: |
+ INSTALL_PATH=$(npm root -g)/machinaos
+ cd "$INSTALL_PATH/server"
+ uv venv
+ uv sync
- name: Verify build artifacts
shell: bash
@@ -143,8 +189,7 @@ jobs:
echo "Installed to: $INSTALL_PATH"
# Check essential files exist
- test -f "$INSTALL_PATH/.env" && echo ".env exists" || echo ".env missing"
- test -d "$INSTALL_PATH/client/dist" && echo "client/dist/ built" || (echo "client/dist/ missing" && exit 1)
+ test -d "$INSTALL_PATH/client/dist" && echo "client/dist/ exists" || (echo "client/dist/ missing" && exit 1)
test -d "$INSTALL_PATH/server/.venv" && echo "server/.venv/ created" || (echo "server/.venv/ missing" && exit 1)
# Verify Python venv is functional
@@ -182,16 +227,9 @@ jobs:
if: runner.os == 'Windows'
shell: pwsh
run: |
- # Get the npm global bin path and pass it to the job
- $npmBin = npm prefix -g
- $job = Start-Job -ScriptBlock {
- param($binPath)
- $env:PATH = "$binPath;$env:PATH"
- machinaos start
- } -ArgumentList $npmBin
+ $job = Start-Job -ScriptBlock { machinaos start }
Start-Sleep -Seconds 15
- # Check if backend is responding
try {
$response = Invoke-WebRequest -Uri "http://localhost:3010/health" -UseBasicParsing -TimeoutSec 5
Write-Host "Backend healthy: $($response.StatusCode)"
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index e444d04d..694edf0a 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -13,9 +13,34 @@ jobs:
predeploy:
uses: ./.github/workflows/predeploy.yml
+ # Build client once after predeploy passes, share with publish jobs
+ build-for-publish:
+ name: Build for Publishing
+ needs: predeploy
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v4
+
+ - name: Setup environment
+ uses: ./.github/actions/setup
+
+ - name: Install and build client
+ run: |
+ cd client
+ npm install
+ npm run build
+
+ - name: Upload built client
+ uses: actions/upload-artifact@v4
+ with:
+ name: client-dist
+ path: client/dist
+ retention-days: 1
+
publish-npm:
name: Publish to npm
- needs: predeploy
+ needs: build-for-publish
runs-on: ubuntu-latest
steps:
- name: Checkout
@@ -27,7 +52,13 @@ jobs:
node-version: '22'
registry-url: 'https://registry.npmjs.org'
- - name: Install dependencies
+ - name: Download built client
+ uses: actions/download-artifact@v4
+ with:
+ name: client-dist
+ path: client/dist
+
+ - name: Install dependencies (skip scripts)
run: npm install --ignore-scripts
- name: Sync versions from git tag
@@ -43,7 +74,7 @@ jobs:
publish-github-packages:
name: Publish to GitHub Packages
- needs: predeploy
+ needs: build-for-publish
runs-on: ubuntu-latest
permissions:
contents: read
@@ -58,7 +89,13 @@ jobs:
node-version: '22'
registry-url: 'https://npm.pkg.github.com'
- - name: Install dependencies
+ - name: Download built client
+ uses: actions/download-artifact@v4
+ with:
+ name: client-dist
+ path: client/dist
+
+ - name: Install dependencies (skip scripts)
run: npm install --ignore-scripts
- name: Sync versions from git tag
diff --git a/README.md b/README.md
index 6b44128e..af9dff25 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,10 @@
Open-source platform to build your own personal AI assistant. A mashup of Claude Code and n8n with better UI, full visibility of each action, and restricted control access.
+## Demo
+
+[![MachinaOS Demo](https://img.youtube.com/vi/z_TEyGmeuyQ/maxresdefault.jpg)](https://www.youtube.com/watch?v=z_TEyGmeuyQ)
+
## Full Capabilities
<img width="1280" height="671" alt="func_img" src="https://github.com/user-attachments/assets/2f14b6c8-3995-4ccc-b076-e40749a83df2" />
@@ -24,7 +28,7 @@ Open http://localhost:3000
<details>
<summary><b>Other Install Options</b></summary>
-### One-Line Install (installs all dependencies automatically)
+### One-Line Install (auto-installs all dependencies)
**Linux/macOS:**
```bash
@@ -79,7 +83,7 @@ npm run docker:up
### 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)
+- **Android** - 16 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
@@ -101,7 +105,7 @@ npm run docker:up
| 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 |
+| Android | 16 | Device control and monitoring |
| Documents | 6 | RAG pipeline nodes |
| Utilities | 5 | HTTP, Webhooks, Chat Trigger, Console |
| Location | 3 | Google Maps integration |
@@ -161,8 +165,7 @@ 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
+│ └── routers/ # API endpoints, WebSocket
├── scripts/ # Cross-platform Node.js scripts
└── bin/cli.js # CLI entry point
```
@@ -171,7 +174,7 @@ MachinaOS/
- **Frontend:** React 19, TypeScript, React Flow, Zustand
- **Backend:** Python 3.12+, FastAPI, SQLite, LangChain/LangGraph
-- **Services:** WhatsApp (Go + whatsmeow), WebSocket relay
+- **Services:** WhatsApp (whatsapp-rpc npm package), WebSocket relay
- **Package Manager:** uv (Python), npm (Node.js)
## Documentation
diff --git a/docker-compose.prod.yml b/docker-compose.prod.yml
index 944d3fbf..a42d5414 100644
--- a/docker-compose.prod.yml
+++ b/docker-compose.prod.yml
@@ -17,6 +17,7 @@ services:
# Python FastAPI Backend
backend:
+ image: machinaos-backend:latest
build:
context: ./server
dockerfile: Dockerfile
@@ -53,6 +54,7 @@ services:
# React Frontend (Production - Nginx)
frontend:
+ image: machinaos-frontend:latest
build:
context: ./client
dockerfile: Dockerfile
@@ -74,6 +76,7 @@ services:
# WhatsApp RPC Service (npm package with pre-built binaries)
whatsapp:
+ image: machinaos-whatsapp:latest
build:
context: ./docker
dockerfile: Dockerfile.whatsapp
diff --git a/install.ps1 b/install.ps1
index 62ec9a8e..354f0e58 100644
--- a/install.ps1
+++ b/install.ps1
@@ -2,19 +2,14 @@
# Usage: iwr -useb https://raw.githubusercontent.com/trohitg/MachinaOS/main/install.ps1 | iex
#
# This script installs MachinaOS and its dependencies:
-# - Node.js 18+ (via winget/choco)
-# - Python 3.11+ (via winget/choco)
+# - Node.js 22+ (via winget/choco)
+# - Python 3.12+ (via winget/choco)
# - uv (Python package manager)
-# - Go 1.21+ (for WhatsApp service)
$ErrorActionPreference = "Stop"
-# Configuration
-$REPO_URL = "https://github.com/trohitg/MachinaOS.git"
-$INSTALL_DIR = if ($env:MACHINAOS_HOME) { $env:MACHINAOS_HOME } else { "$env:USERPROFILE\.machinaos" }
-$MIN_NODE_VERSION = 18
-$MIN_PYTHON_VERSION = "3.11"
-$MIN_GO_VERSION = "1.21"
+$MIN_NODE_VERSION = 22
+$MIN_PYTHON_VERSION = "3.12"
# Colors
function Write-Color {
@@ -51,6 +46,11 @@ function Get-PackageManager {
return $null
}
+# Refresh PATH from registry
+function Refresh-Path {
+ $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+}
+
# =============================================================================
# Dependency Checks and Installation
# =============================================================================
@@ -69,7 +69,7 @@ function Check-Node {
}
function Install-Node {
- Info "Installing Node.js..."
+ Info "Installing Node.js $MIN_NODE_VERSION..."
$pm = Get-PackageManager
switch ($pm) {
@@ -84,8 +84,7 @@ function Install-Node {
}
}
- # Refresh PATH
- $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+ Refresh-Path
if (-not (Check-Node)) {
Error-Exit "Failed to install Node.js. Please install manually and restart PowerShell."
@@ -95,11 +94,15 @@ function Install-Node {
function Check-Python {
foreach ($cmd in @("python", "python3")) {
if (Has-Command $cmd) {
- $version = & $cmd --version 2>&1 | Select-String -Pattern "\d+\.\d+" | ForEach-Object { $_.Matches.Value }
- if ($version -ge $MIN_PYTHON_VERSION) {
- Success "Python $version ($cmd)"
- $script:PYTHON_CMD = $cmd
- return $true
+ $versionOutput = & $cmd --version 2>&1
+ if ($versionOutput -match "Python (\d+)\.(\d+)") {
+ $major = [int]$Matches[1]
+ $minor = [int]$Matches[2]
+ if ($major -ge 3 -and $minor -ge 12) {
+ Success "Python $major.$minor ($cmd)"
+ $script:PYTHON_CMD = $cmd
+ return $true
+ }
}
}
}
@@ -108,7 +111,7 @@ function Check-Python {
}
function Install-Python {
- Info "Installing Python..."
+ Info "Installing Python $MIN_PYTHON_VERSION..."
$pm = Get-PackageManager
switch ($pm) {
@@ -123,8 +126,7 @@ function Install-Python {
}
}
- # Refresh PATH
- $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+ Refresh-Path
if (-not (Check-Python)) {
Error-Exit "Failed to install Python. Please install manually and restart PowerShell."
@@ -142,9 +144,18 @@ function Check-Uv {
function Install-Uv {
Info "Installing uv (Python package manager)..."
- Invoke-RestMethod https://astral.sh/uv/install.ps1 | Invoke-Expression
- # Add to PATH for current session
+ # Try pip first
+ if ($script:PYTHON_CMD) {
+ try {
+ & $script:PYTHON_CMD -m pip install uv 2>&1 | Out-Null
+ Refresh-Path
+ if (Check-Uv) { return }
+ } catch {}
+ }
+
+ # Fallback to official installer
+ Invoke-RestMethod https://astral.sh/uv/install.ps1 | Invoke-Expression
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
if (-not (Check-Uv)) {
@@ -152,119 +163,6 @@ function Install-Uv {
}
}
-function Check-Go {
- if (Has-Command "go") {
- $versionOutput = go version
- if ($versionOutput -match "go(\d+\.\d+)") {
- $version = $Matches[1]
- if ($version -ge $MIN_GO_VERSION) {
- Success "Go $version"
- return $true
- }
- Warn "Go $version is too old (need $MIN_GO_VERSION+)"
- }
- }
- return $false
-}
-
-function Install-Go {
- Info "Installing Go..."
- $pm = Get-PackageManager
-
- switch ($pm) {
- "winget" {
- winget install GoLang.Go --accept-package-agreements --accept-source-agreements
- }
- "choco" {
- choco install golang -y
- }
- default {
- Error-Exit "Please install winget or chocolatey, or install Go manually from https://go.dev/dl/"
- }
- }
-
- # Refresh PATH
- $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-
- if (-not (Check-Go)) {
- Error-Exit "Failed to install Go. Please install manually and restart PowerShell."
- }
-}
-
-function Check-Git {
- if (Has-Command "git") {
- $version = (git --version) -replace "git version ", ""
- Success "Git $version"
- return $true
- }
- return $false
-}
-
-function Install-Git {
- Info "Installing Git..."
- $pm = Get-PackageManager
-
- switch ($pm) {
- "winget" {
- winget install Git.Git --accept-package-agreements --accept-source-agreements
- }
- "choco" {
- choco install git -y
- }
- default {
- Error-Exit "Please install winget or chocolatey, or install Git manually from https://git-scm.com/"
- }
- }
-
- # Refresh PATH
- $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-
- if (-not (Check-Git)) {
- Error-Exit "Failed to install Git. Please install manually and restart PowerShell."
- }
-}
-
-# =============================================================================
-# MachinaOS Installation
-# =============================================================================
-
-function Install-MachinaOS {
- Write-Host ""
- Info "Installing MachinaOS to $INSTALL_DIR..."
-
- # Create install directory
- if (-not (Test-Path $INSTALL_DIR)) {
- New-Item -ItemType Directory -Path $INSTALL_DIR -Force | Out-Null
- }
-
- # Clone or update repository
- if (Test-Path "$INSTALL_DIR\.git") {
- Info "Updating existing installation..."
- Push-Location $INSTALL_DIR
- git pull origin main
- } else {
- Info "Cloning repository..."
- git clone $REPO_URL $INSTALL_DIR
- Push-Location $INSTALL_DIR
- }
-
- # Run build
- Info "Building MachinaOS..."
- npm run build
-
- Pop-Location
-
- # Add to PATH suggestion
- $binPath = "$INSTALL_DIR\bin"
- if ($env:Path -notlike "*$binPath*") {
- Warn "Add MachinaOS to your PATH:"
- Write-Host ""
- Write-Host " # Run this command to add to PATH permanently:"
- Write-Host " [Environment]::SetEnvironmentVariable('Path', `$env:Path + ';$binPath', 'User')"
- Write-Host ""
- }
-}
-
# =============================================================================
# Main Installation Flow
# =============================================================================
@@ -275,14 +173,16 @@ function Main {
Write-Host ""
# Check and install dependencies
- if (-not (Check-Git)) { Install-Git }
if (-not (Check-Node)) { Install-Node }
if (-not (Check-Python)) { Install-Python }
if (-not (Check-Uv)) { Install-Uv }
- if (-not (Check-Go)) { Install-Go }
- # Install MachinaOS
- Install-MachinaOS
+ Write-Host ""
+ Info "Installing MachinaOS..."
+ Write-Host ""
+
+ # Install machinaos from npm
+ npm install -g machinaos
Write-Host ""
Write-Color "============================================" "Green"
@@ -290,18 +190,11 @@ function Main {
Write-Color "============================================" "Green"
Write-Host ""
Write-Host " Start MachinaOS:"
- Write-Host " cd $INSTALL_DIR"
- Write-Host " npm run start"
- Write-Host ""
- Write-Host " Or use the CLI:"
- Write-Host " node $INSTALL_DIR\bin\cli.js start"
+ Write-Host " machinaos start"
Write-Host ""
Write-Host " Open in browser:"
Write-Host " http://localhost:3000"
Write-Host ""
- Write-Host " Documentation:"
- Write-Host " https://github.com/trohitg/MachinaOS"
- Write-Host ""
}
# Run main
diff --git a/install.sh b/install.sh
index 967ca97c..ada17be4 100644
--- a/install.sh
+++ b/install.sh
@@ -1,55 +1,216 @@
#!/usr/bin/env bash
# MachinaOS Installer
-# Prerequisites: Node.js 22+, Python 3.12+
-#
# Usage: curl -fsSL https://raw.githubusercontent.com/trohitg/MachinaOS/main/install.sh | bash
+#
+# This script installs MachinaOS and its dependencies:
+# - Node.js 22+ (via brew/apt/dnf/pacman)
+# - Python 3.12+ (via brew/apt/dnf/pacman)
+# - uv (Python package manager)
set -e
-echo "Installing MachinaOS..."
-echo ""
+MIN_NODE_VERSION=22
+MIN_PYTHON_VERSION_MINOR=12
-# Check Node.js
-if ! command -v node &> /dev/null; then
- echo "Error: Node.js 22+ is required"
- echo " Install from: https://nodejs.org/"
- exit 1
-fi
-echo " Node.js: $(node --version)"
-
-# Check Python
-if command -v python3 &> /dev/null; then
- PY=python3
-elif command -v python &> /dev/null; then
- PY=python
-else
- echo "Error: Python 3.12+ is required"
- echo " Install from: https://python.org/"
- exit 1
-fi
-echo " Python: $($PY --version)"
-
-# Ensure pip is available (use ensurepip if missing)
-if ! $PY -m pip --version &> /dev/null; then
- echo " Installing pip..."
- $PY -m ensurepip --upgrade
-fi
-
-# Install uv via pip if not found
-if ! command -v uv &> /dev/null; then
- echo " Installing uv..."
- $PY -m pip install uv
-fi
-echo " uv: $(uv --version)"
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
-echo ""
-
-# Install machinaos from npm (includes whatsapp-rpc)
-npm install -g machinaos
+info() { echo -e "${CYAN}[INFO]${NC} $*"; }
+success() { echo -e "${GREEN}[OK]${NC} $*"; }
+warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
+error_exit() { echo -e "${RED}[ERROR]${NC} $*"; exit 1; }
+# Banner
echo ""
-echo "MachinaOS installed successfully!"
+echo -e "${CYAN} __ __ _ _ ___ ____ ${NC}"
+echo -e "${CYAN} | \\/ | __ _ ___| |__ (_)_ __ __ _/ _ \\/ ___| ${NC}"
+echo -e "${CYAN} | |\\/| |/ _\` |/ __| '_ \\| | '_ \\ / _\` | | | \\___ \\ ${NC}"
+echo -e "${CYAN} | | | | (_| | (__| | | | | | | | (_| | |_| |___) |${NC}"
+echo -e "${CYAN} |_| |_|\\__,_|\\___|_| |_|_|_| |_|\\__,_|\\___/|____/ ${NC}"
echo ""
-echo " Start: machinaos start"
-echo " Open: http://localhost:3000"
+echo "Open-source workflow automation with AI agents"
echo ""
+
+# Detect OS
+detect_os() {
+ if [[ "$OSTYPE" == "darwin"* ]]; then
+ echo "macos"
+ elif [[ -f /etc/debian_version ]]; then
+ echo "debian"
+ elif [[ -f /etc/redhat-release ]]; then
+ echo "redhat"
+ elif [[ -f /etc/arch-release ]]; then
+ echo "arch"
+ else
+ echo "unknown"
+ fi
+}
+
+OS=$(detect_os)
+
+# =============================================================================
+# Dependency Checks and Installation
+# =============================================================================
+
+check_node() {
+ if command -v node &> /dev/null; then
+ version=$(node --version | tr -d 'v')
+ major=$(echo "$version" | cut -d. -f1)
+ if [ "$major" -ge "$MIN_NODE_VERSION" ]; then
+ success "Node.js v$version"
+ return 0
+ fi
+ warn "Node.js v$version is too old (need v$MIN_NODE_VERSION+)"
+ fi
+ return 1
+}
+
+install_node() {
+ info "Installing Node.js $MIN_NODE_VERSION..."
+
+ case "$OS" in
+ macos)
+ if command -v brew &> /dev/null; then
+ brew install node@22
+ else
+ error_exit "Please install Homebrew first: https://brew.sh/"
+ fi
+ ;;
+ debian)
+ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+ sudo apt-get install -y nodejs
+ ;;
+ redhat)
+ curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
+ sudo dnf install -y nodejs
+ ;;
+ arch)
+ sudo pacman -S --noconfirm nodejs npm
+ ;;
+ *)
+ error_exit "Please install Node.js 22+ manually from https://nodejs.org/"
+ ;;
+ esac
+
+ if ! check_node; then
+ error_exit "Failed to install Node.js. Please install manually."
+ fi
+}
+
+check_python() {
+ for cmd in python3 python; do
+ if command -v "$cmd" &> /dev/null; then
+ version=$($cmd --version 2>&1 | grep -oP '\d+\.\d+' | head -1)
+ major=$(echo "$version" | cut -d. -f1)
+ minor=$(echo "$version" | cut -d. -f2)
+ if [ "$major" -ge 3 ] && [ "$minor" -ge "$MIN_PYTHON_VERSION_MINOR" ]; then
+ success "Python $version ($cmd)"
+ PYTHON_CMD="$cmd"
+ return 0
+ fi
+ fi
+ done
+ warn "Python 3.$MIN_PYTHON_VERSION_MINOR+ not found"
+ return 1
+}
+
+install_python() {
+ info "Installing Python 3.$MIN_PYTHON_VERSION_MINOR..."
+
+ case "$OS" in
+ macos)
+ if command -v brew &> /dev/null; then
+ brew install [email protected]
+ else
+ error_exit "Please install Homebrew first: https://brew.sh/"
+ fi
+ ;;
+ debian)
+ sudo apt-get update
+ sudo apt-get install -y python3.12 python3.12-venv python3-pip
+ ;;
+ redhat)
+ sudo dnf install -y python3.12
+ ;;
+ arch)
+ sudo pacman -S --noconfirm python python-pip
+ ;;
+ *)
+ error_exit "Please install Python 3.12+ manually from https://python.org/"
+ ;;
+ esac
+
+ if ! check_python; then
+ error_exit "Failed to install Python. Please install manually."
+ fi
+}
+
+check_uv() {
+ if command -v uv &> /dev/null; then
+ version=$(uv --version | tr -d 'uv ')
+ success "uv $version"
+ return 0
+ fi
+ return 1
+}
+
+install_uv() {
+ info "Installing uv (Python package manager)..."
+
+ # Try pip first
+ if [ -n "$PYTHON_CMD" ]; then
+ if $PYTHON_CMD -m pip install uv 2>/dev/null; then
+ export PATH="$HOME/.local/bin:$PATH"
+ if check_uv; then return 0; fi
+ fi
+ fi
+
+ # Fallback to official installer
+ curl -LsSf https://astral.sh/uv/install.sh | sh
+ export PATH="$HOME/.local/bin:$PATH"
+
+ if ! check_uv; then
+ error_exit "Failed to install uv"
+ fi
+}
+
+# =============================================================================
+# Main Installation Flow
+# =============================================================================
+
+main() {
+ echo ""
+ info "Checking dependencies..."
+ echo ""
+
+ # Check and install dependencies
+ check_node || install_node
+ check_python || install_python
+ check_uv || install_uv
+
+ echo ""
+ info "Installing MachinaOS..."
+ echo ""
+
+ # Install machinaos from npm
+ npm install -g machinaos
+
+ echo ""
+ echo -e "${GREEN}============================================${NC}"
+ echo -e "${GREEN} MachinaOS installed successfully!${NC}"
+ echo -e "${GREEN}============================================${NC}"
+ echo ""
+ echo " Start MachinaOS:"
+ echo " machinaos start"
+ echo ""
+ echo " Open in browser:"
+ echo " http://localhost:3000"
+ echo ""
+}
+
+# Run main
+main
diff --git a/scripts/start.js b/scripts/start.js
index aaf93ac6..e966ab48 100644
--- a/scripts/start.js
+++ b/scripts/start.js
@@ -15,7 +15,7 @@ const START_TIME = Date.now();
// Parse command line arguments
const args = process.argv.slice(2);
const isDaemonMode = args.includes('--daemon');
-const skipWhatsApp = args.includes('--skip-whatsapp') || process.env.CI === 'true';
+const skipWhatsApp = args.includes('--skip-whatsapp');
// ============================================================================
// Platform Detection
@@ -229,7 +229,7 @@ if (isProduction) {
// Python backend: use gunicorn in daemon mode, uvicorn in development
services.push(isDaemonMode ? 'npm:python:daemon' : 'npm:python:start');
-// WhatsApp RPC service - skip in CI (binary download is disabled in CI)
+// WhatsApp RPC service (required)
if (!skipWhatsApp) {
services.push('npm:whatsapp:api');
}