machinaos 0.0.1

package/docker-compose.yml

@@ -0,0 +1,104 @@
+services:
+  # Redis Cache (only starts with --profile redis or COMPOSE_PROFILES=redis)
+  redis:
+    image: redis:7-alpine
+    container_name: machina-redis
+    profiles:
+      - redis
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    volumes:
+      - redis-data:/data
+    networks:
+      - app-network
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+    command: redis-server --appendonly yes
+
+  # Python FastAPI Backend
+  backend:
+    build:
+      context: ./server
+      dockerfile: Dockerfile
+    container_name: machina-backend
+    ports:
+      - "${PYTHON_BACKEND_PORT:-3010}:${PYTHON_BACKEND_PORT:-3010}"
+    volumes:
+      - ./server:/app
+      - backend-data:/app/data
+    networks:
+      - app-network
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:${PYTHON_BACKEND_PORT:-3010}/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+    env_file:
+      - .env
+    environment:
+      # Override specific vars for Docker networking
+      - PORT=${PYTHON_BACKEND_PORT:-3010}
+      - REDIS_URL=redis://redis:6379
+      - WHATSAPP_RPC_URL=ws://whatsapp:${WHATSAPP_RPC_PORT:-9400}/ws/rpc
+      - TZ=UTC
+    depends_on:
+      whatsapp:
+        condition: service_healthy
+
+  # React Frontend (Vite) - Production build served via nginx
+  frontend:
+    build:
+      context: ./client
+      dockerfile: Dockerfile
+      target: production
+      args:
+        - VITE_AUTH_ENABLED=${VITE_AUTH_ENABLED:-true}
+    container_name: machina-frontend
+    ports:
+      - "${VITE_CLIENT_PORT:-3000}:80"
+    networks:
+      - app-network
+    restart: unless-stopped
+    depends_on:
+      - backend
+
+  # WhatsApp RPC Service (Go API)
+  whatsapp:
+    build:
+      context: ./server/whatsapp-rpc
+      dockerfile: Dockerfile
+    container_name: machina-whatsapp
+    ports:
+      - "${WHATSAPP_RPC_PORT:-9400}:${WHATSAPP_RPC_PORT:-9400}"
+    volumes:
+      - whatsapp-data:/app/data
+    networks:
+      - app-network
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:${WHATSAPP_RPC_PORT:-9400}/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 15s
+    environment:
+      - TZ=UTC
+      - PORT=${WHATSAPP_RPC_PORT:-9400}
+
+networks:
+  app-network:
+    driver: bridge
+
+volumes:
+  redis-data:
+    driver: local
+  backend-data:
+    driver: local
+  whatsapp-data:
+    driver: local

package/docs-MachinaOs/README.md

@@ -0,0 +1,85 @@
+# MachinaOs Documentation
+
+This folder contains the Mintlify documentation for MachinaOs.
+
+## Setup
+
+1. Create a new repository `trohitg/machinaos-docs` on GitHub
+2. Copy the contents of this folder to the new repository
+3. Connect the repository to Mintlify:
+   - Go to [mintlify.com](https://mintlify.com)
+   - Click "Get Started" and sign in with GitHub
+   - Select your `machinaos-docs` repository
+   - Mintlify will automatically deploy your docs
+
+## Local Development
+
+```bash
+# Install Mintlify CLI
+npm install -g mintlify
+
+# Run local dev server
+cd docs-mintlify
+mintlify dev
+```
+
+The docs will be available at http://localhost:3000
+
+## Structure
+
+```
+docs-mintlify/
+├── docs.json           # Mintlify configuration
+├── introduction.mdx    # Home page
+├── installation.mdx    # Setup guide
+├── quickstart.mdx      # Quick start tutorial
+├── faq.mdx            # FAQ page
+├── tutorials/         # Step-by-step guides
+│   ├── first-workflow.mdx
+│   ├── ai-agent-workflow.mdx
+│   ├── whatsapp-automation.mdx
+│   └── android-automation.mdx
+├── nodes/             # Node documentation
+│   ├── overview.mdx
+│   ├── ai-models.mdx
+│   ├── ai-agent.mdx
+│   ├── whatsapp.mdx
+│   ├── android.mdx
+│   ├── webhooks.mdx
+│   └── schedulers.mdx
+├── deployment/        # Deployment guides
+│   ├── docker.mdx
+│   └── production.mdx
+├── logo/              # Logo assets
+│   ├── dark.svg
+│   └── light.svg
+├── images/            # Screenshots and diagrams
+└── favicon.svg        # Browser favicon
+```
+
+## Adding Content
+
+1. Create new `.mdx` files in the appropriate folder
+2. Add frontmatter with title and description:
+   ```mdx
+   ---
+   title: Page Title
+   description: Brief description
+   ---
+   ```
+3. Update `docs.json` navigation to include new pages
+4. Commit and push - Mintlify auto-deploys
+
+## Mintlify Components
+
+Common components used in docs:
+
+- `<Card>` - Feature cards with icons
+- `<CardGroup>` - Grid layout for cards
+- `<Tabs>` - Tabbed content
+- `<Accordion>` - Collapsible sections
+- `<Info>`, `<Warning>`, `<Tip>` - Callout boxes
+- `<ParamField>` - Parameter documentation
+- `<Check>` - Success checkmarks
+
+See [Mintlify docs](https://mintlify.com/docs) for full component reference.

package/docs-MachinaOs/deployment/docker.mdx

@@ -0,0 +1,228 @@
+---
+title: Docker Setup
+description: Run MachinaOs with Docker Compose
+---
+
+# Docker Setup
+
+The easiest way to run MachinaOs is with Docker Compose.
+
+## Prerequisites
+
+- Docker 20.10+
+- Docker Compose 2.0+
+- 2GB RAM minimum
+
+## Quick Start
+
+```bash
+# Clone the repository
+git clone https://github.com/trohitg/MachinaOS.git
+cd MachinaOs
+
+# Build images
+npm run docker:build
+
+# Start all services
+npm run docker:up
+```
+
+This starts 4 containers:
+- **frontend** - React app on port 3000
+- **backend** - FastAPI server on port 3010
+- **whatsapp** - Go WhatsApp service on port 9400
+- **redis** - Cache on port 6379 (optional)
+
+## Container Overview
+
+| Container | Image | Port | Purpose |
+|-----------|-------|------|---------|
+| frontend | machinaos-frontend | 3000 | React UI |
+| backend | machinaos-backend | 3010 | API server |
+| whatsapp | machinaos-whatsapp | 9400 | WhatsApp bridge |
+| redis | redis:7-alpine | 6379 | Cache (optional) |
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file in the project root:
+
+```bash
+# Ports
+VITE_CLIENT_PORT=3000
+PYTHON_BACKEND_PORT=3010
+WHATSAPP_RPC_PORT=9400
+
+# Authentication
+AUTH_MODE=single
+JWT_SECRET_KEY=your-secret-key-min-32-chars
+
+# Cache (optional)
+REDIS_ENABLED=false
+
+# AI API Keys (optional)
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+```
+
+### Redis (Optional)
+
+Redis is disabled by default for local development. To enable:
+
+```bash
+# In .env
+REDIS_ENABLED=true
+```
+
+Then start with Redis profile:
+
+```bash
+docker-compose --profile redis up -d
+```
+
+## Common Commands
+
+```bash
+# Start services
+npm run docker:up
+
+# View logs
+npm run docker:logs
+
+# Stop all services
+npm run docker:down
+
+# Rebuild after code changes
+npm run docker:build && npm run docker:up
+
+# Stop and remove volumes (clean slate)
+docker-compose down -v
+
+# View specific service logs
+docker-compose logs -f backend
+
+# Restart specific service
+docker-compose restart backend
+```
+
+## Accessing Services
+
+After starting, access:
+
+| Service | URL |
+|---------|-----|
+| Frontend | http://localhost:3000 |
+| Backend API | http://localhost:3010 |
+| Health Check | http://localhost:3010/health |
+| WebSocket | ws://localhost:3010/ws/status |
+
+## Health Checks
+
+All containers include health checks:
+
+```bash
+# Check container health
+docker-compose ps
+
+# Check backend health
+curl http://localhost:3010/health
+```
+
+Expected health response:
+```json
+{
+  "status": "healthy",
+  "redis_enabled": false,
+  "version": "1.0.0"
+}
+```
+
+## Troubleshooting
+
+<Accordion title="Container won't start">
+  Check logs for errors:
+  ```bash
+  docker-compose logs backend
+  docker-compose logs frontend
+  ```
+
+  Common issues:
+  - Port already in use: Change port in `.env`
+  - Missing environment variables: Check `.env` file exists
+</Accordion>
+
+<Accordion title="Frontend can't connect to backend">
+  - Verify both containers are running: `docker-compose ps`
+  - Check network: containers should be on same network
+  - Check CORS settings in backend `.env`
+</Accordion>
+
+<Accordion title="WhatsApp service issues">
+  ```bash
+  # Check WhatsApp logs
+  docker-compose logs whatsapp
+
+  # Restart WhatsApp service
+  docker-compose restart whatsapp
+  ```
+</Accordion>
+
+<Accordion title="Out of disk space">
+  Clean up Docker resources:
+  ```bash
+  docker system prune -af
+  docker builder prune -af
+  ```
+</Accordion>
+
+## Resource Usage
+
+Typical resource consumption:
+
+| Container | Memory | CPU |
+|-----------|--------|-----|
+| frontend | ~50 MB | Low |
+| backend | ~150 MB | Medium |
+| whatsapp | ~30 MB | Low |
+| redis | ~10 MB | Low |
+
+## Data Persistence
+
+Data is stored in Docker volumes:
+
+| Volume | Purpose |
+|--------|---------|
+| backend-data | SQLite database, uploads |
+| whatsapp-data | WhatsApp session |
+| redis-data | Cache data |
+
+To backup data:
+```bash
+docker cp machinaos-backend-1:/app/data ./backup
+```
+
+## Development Mode
+
+For development with hot reload:
+
+```bash
+# Use development compose file
+docker-compose -f docker-compose.dev.yml up
+```
+
+Or run services separately:
+```bash
+npm run dev  # Starts frontend + backend with hot reload
+```
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Production Deployment" icon="server" href="/deployment/production">
+    Deploy to a server with nginx and SSL
+  </Card>
+  <Card title="Configuration" icon="gear" href="/installation">
+    Full environment variable reference
+  </Card>
+</CardGroup>