cicy-desktop 1.0.8

package/DOCKER.md

@@ -0,0 +1,85 @@
+# Electron RCP Docker
+
+Docker image for electron-rcp with browser automation capabilities.
+
+## Features
+
+- Node.js 22
+- Electron with Xvfb (headless)
+- Python 3 + pip
+- Non-root user (electron)
+- Port 8101 exposed
+
+## Build
+
+```bash
+docker build -t electron-rcp .
+```
+
+## Run
+
+```bash
+docker run -d \
+  --name electron-rcp \
+  -p 8101:8101 \
+  -e TOKEN=your-token-here \
+  --cap-add=SYS_ADMIN \
+  electron-rcp
+```
+
+## Usage
+
+### Check status
+```bash
+docker exec electron-rcp electron-rpc status
+```
+
+### View logs
+```bash
+docker logs electron-rcp
+# or
+docker exec electron-rcp tail -f /home/electron/logs/electron-mcp.log
+```
+
+### Use cicy-rpc from host
+```bash
+# Set token on host
+echo "your-token-here" > ~/data/electron/token.txt
+
+# Test connection
+cicy-rpc ping
+
+# Open window
+cicy-rpc open_window url=https://google.com
+
+# Take screenshot
+cicy-rpc webpage_snapshot win_id=1
+```
+
+### Extract screenshot to host
+```bash
+curl -s http://localhost:8101/rpc/tools/call \
+  -H "Authorization: Bearer $(cat ~/data/electron/token.txt)" \
+  -H "Content-Type: application/json" \
+  -d '{"name":"webpage_snapshot","arguments":{"win_id":1}}' | \
+  jq -r '.result.content[] | select(.type=="image") | .data' | \
+  base64 -d > screenshot.png
+```
+
+### Execute shell commands
+```bash
+cicy-rpc exec_shell command="pip3 install package-name --break-system-packages"
+```
+
+## Environment Variables
+
+- `TOKEN`: Authentication token (default: your-token-here)
+- `DISPLAY`: X display (default: :99)
+
+## Stop and Remove
+
+```bash
+docker stop electron-rcp
+docker rm electron-rcp
+```
+

package/Dockerfile

@@ -0,0 +1,46 @@
+FROM node:22
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    xvfb \
+    libgtk-3-0 \
+    libnotify4 \
+    libnss3 \
+    libxss1 \
+    libxtst6 \
+    xdg-utils \
+    libatspi2.0-0 \
+    libdrm2 \
+    libgbm1 \
+    libasound2 \
+    python3-pip \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+RUN useradd -m -s /bin/bash electron
+
+# Install electron-rcp globally
+RUN npm install -g electron-rcp
+
+# Configure chrome-sandbox
+RUN chown root:root /usr/local/lib/node_modules/electron/dist/chrome-sandbox && \
+    chmod 4755 /usr/local/lib/node_modules/electron/dist/chrome-sandbox
+
+# Switch to non-root user
+USER electron
+WORKDIR /home/electron
+
+# Create token file
+RUN echo "your-token-here" > /home/electron/electron-mcp-token.txt
+
+# Set display
+ENV DISPLAY=:99
+
+# Expose port
+EXPOSE 8101
+
+# Start Xvfb and electron-rpc
+CMD Xvfb :99 -screen 0 1024x768x24 & \
+    sleep 3 && \
+    electron-rpc start && \
+    tail -f /home/electron/logs/electron-mcp.log