#!/usr/bin/env bash # Deploy Local Studio from this machine to the remote GPU server. # # ─── Connection ─────────────────────────────────────────────────────────── # # Remote connection values are intentionally loaded from .env.local. # Required: REMOTE_HOST, REMOTE_USER, REMOTE_PATH. # Optional: REMOTE_SSH_KEY (defaults to ~/.ssh/id_ed25519). # # ─── What runs where ───────────────────────────────────────────────────── # # Docker (infra only, stays up across deploys): # postgres:16 :5432 optional database service # # Native on host (needs nvidia-smi + host process visibility): # controller (bun) :8080 Model lifecycle, GPU stats, chat, recipes # frontend (next) :3000 Web UI # agent-runtime :8081 Standalone pi agent runtime sidecar (node, # user systemd unit local-studio-agent-runtime). # The frontend proxies its runtime/browser routes # here via LOCAL_STUDIO_AGENT_RUNTIME_URL= # http://127.0.0.1:8081 (exported by # restart_frontend below) — required so SSE # flushes through Next's standalone server. # # Managed separately: # vLLM / SGLang :8000 Inference (launched via controller or manually) # # ─── How it works ───────────────────────────────────────────────────────── # # 1. rsync — push controller/src, frontend/src, shared/ to remote # 2. install — bun install (controller), npm install (frontend) # 3. restart — kill old process, start new one via nohup, wait for port # 4. verify — hit health endpoints, print GPU and model status # # ─── Usage ──────────────────────────────────────────────────────────────── # # ./scripts/deploy-remote.sh Deploy everything # ./scripts/deploy-remote.sh controller Controller only # ./scripts/deploy-remote.sh frontend Frontend only # ./scripts/deploy-remote.sh agent-runtime Agent-runtime sidecar only # ./scripts/deploy-remote.sh infra Restart Docker infra # ./scripts/deploy-remote.sh status Check what's running (no changes) set -euo pipefail cd "$(dirname "$0")/.." # ─── Config ─────────────────────────────────────────────────────────────── if [[ -f .env.local ]]; then set -a # shellcheck disable=SC1091 source .env.local set +a fi : "${REMOTE_HOST:?Set REMOTE_HOST in .env.local}" : "${REMOTE_USER:?Set REMOTE_USER in .env.local}" : "${REMOTE_PATH:?Set REMOTE_PATH in .env.local}" SSH_KEY="${REMOTE_SSH_KEY:-$HOME/.ssh/id_ed25519}" REMOTE_DIR="$REMOTE_PATH" REMOTE_DIR_SHELL="$(printf '%q' "$REMOTE_DIR")" SSH_OPTS="-T -i $SSH_KEY -o ConnectTimeout=5" REMOTE="$REMOTE_USER@$REMOTE_HOST" # ─── Output ─────────────────────────────────────────────────────────────── _c() { printf '\033[%sm' "$1"; } _r="$(_c 31)" _g="$(_c 32)" _y="$(_c 33)" _b="$(_c 36)" _d="$(_c 2)" _n="$(_c 0)" step() { printf '%s==>%s %s\n' "$_b" "$_n" "$*"; } ok() { printf '%s ✓%s %s\n' "$_g" "$_n" "$*"; } warn() { printf '%s !%s %s\n' "$_y" "$_n" "$*"; } fail() { printf '%s ✗%s %s\n' "$_r" "$_n" "$*"; } dim() { printf '%s%s%s\n' "$_d" "$*" "$_n"; } die() { fail "$@"; exit 1; } # ─── Helpers ────────────────────────────────────────────────────────────── remote() { ssh $SSH_OPTS "$REMOTE" "$@"; } # rsync a local directory to remote, excluding node_modules and build artifacts sync_dir() { local src="$1" dst="$2" rsync -az --delete \ --exclude 'node_modules' \ --exclude '.next' \ --exclude 'bun.lock' \ --exclude '.turbo' \ --exclude '*.test.ts' \ --exclude 'test-output' \ -e "ssh $SSH_OPTS" \ "$src" "$REMOTE:$dst" 2>&1 | grep -v 'cannot delete non-empty directory' || true } # Wait for a port to be listening, or fail after N seconds wait_port() { local port="$1" label="$2" max="${3:-10}" for i in $(seq 1 "$max"); do if remote "ss -tlnp | grep -q ':${port}\b'" 2>/dev/null; then return 0 fi sleep 1 done fail "$label not listening on :$port after ${max}s" remote "tail -20 /tmp/${label}-stdout.log" 2>/dev/null || true return 1 } # ─── Sync ───────────────────────────────────────────────────────────────── sync_controller() { step "Syncing controller" sync_dir controller/src/ "$REMOTE_DIR/controller/src/" sync_dir controller/scripts/ "$REMOTE_DIR/controller/scripts/" 2>/dev/null || true rsync -az -e "ssh $SSH_OPTS" \ controller/package.json controller/bun.lock controller/tsconfig.json \ "$REMOTE:$REMOTE_DIR/controller/" 2>/dev/null ok "controller/src → remote" } sync_frontend() { step "Syncing frontend" sync_dir frontend/src/ "$REMOTE_DIR/frontend/src/" sync_dir frontend/scripts/ "$REMOTE_DIR/frontend/scripts/" 2>/dev/null || true local frontend_files=( frontend/package.json frontend/package-lock.json frontend/tsconfig.json frontend/next.config.ts frontend/tailwind.config.ts frontend/postcss.config.mjs ) local existing_frontend_files=() for file in "${frontend_files[@]}"; do [[ -e "$file" ]] && existing_frontend_files+=("$file") done rsync -az -e "ssh $SSH_OPTS" \ "${existing_frontend_files[@]}" \ "$REMOTE:$REMOTE_DIR/frontend/" 2>/dev/null ok "frontend/src → remote" } sync_shared() { step "Syncing shared types" sync_dir shared/ "$REMOTE_DIR/shared/" ok "shared/ → remote" } sync_services() { step "Syncing services (agent-runtime)" # services/node_modules is a symlink bridge to frontend/node_modules # (recreated by frontend postinstall); rsync must not follow or delete it. rsync -az --delete \ --exclude 'node_modules' \ --exclude 'dist' \ --exclude '*.test.ts' \ -e "ssh $SSH_OPTS" \ services/agent-runtime/ "$REMOTE:$REMOTE_DIR/services/agent-runtime/" 2>&1 | grep -v 'cannot delete non-empty directory' || true remote "mkdir -p $REMOTE_DIR_SHELL/scripts/systemd" rsync -az -e "ssh $SSH_OPTS" \ scripts/systemd/local-studio-agent-runtime.service \ "$REMOTE:$REMOTE_DIR/scripts/systemd/" ok "services/agent-runtime → remote" } sync_config() { step "Syncing infra config" remote "rm -rf $REMOTE_DIR_SHELL/config" rsync -az -e "ssh $SSH_OPTS" \ docker-compose.yml .env.example \ "$REMOTE:$REMOTE_DIR/" ok "docker-compose.yml → remote, removed legacy config/" } sync_all() { sync_controller sync_frontend sync_shared sync_services sync_config } # ─── Install ────────────────────────────────────────────────────────────── install_controller() { step "Installing controller deps" if remote "cd $REMOTE_DIR_SHELL/controller && ~/.bun/bin/bun install --frozen-lockfile >/tmp/controller-bun-install.log 2>&1"; then remote "tail -5 /tmp/controller-bun-install.log" else remote "tail -20 /tmp/controller-bun-install.log" || true remote "cd $REMOTE_DIR_SHELL/controller && ~/.bun/bin/bun install >/tmp/controller-bun-install.log 2>&1" remote "tail -5 /tmp/controller-bun-install.log" fi ok "bun install" } install_frontend() { step "Installing frontend deps" remote "cd $REMOTE_DIR_SHELL/frontend && npm install --silent 2>&1 | tail -3" remote "cd $REMOTE_DIR_SHELL/frontend && node scripts/patch-pi-ai-openai-text-boundaries.mjs" ok "npm install" } build_frontend_local() { step "Building frontend locally" (cd frontend && npm run build) ok "local next build" step "Syncing frontend build" remote "rm -rf $REMOTE_DIR_SHELL/frontend/.next/standalone/data" rsync -az --delete \ --exclude 'cache' \ --exclude 'standalone/data' \ -e "ssh $SSH_OPTS" \ frontend/.next/ "$REMOTE:$REMOTE_DIR/frontend/.next/" 2>/dev/null ok ".next/ → remote" } # Build the agent-runtime sidecar on the remote. tsc + node resolve through # services/node_modules -> frontend/node_modules (created by the frontend # postinstall), so install_frontend must have run at least once before this. build_agent_runtime() { step "Building agent-runtime (tsc → dist/)" remote "cd $REMOTE_DIR_SHELL/services/agent-runtime && npm run build >/tmp/agent-runtime-build.log 2>&1" || { remote "tail -20 /tmp/agent-runtime-build.log" || true; return 1; } ok "services/agent-runtime/dist" } # ─── Restart ────────────────────────────────────────────────────────────── # Restart the agent-runtime sidecar via its user systemd unit. Installs/updates # the unit from scripts/systemd/local-studio-agent-runtime.service, filling the # @APP_DIR@ and @NODE@ placeholders with the remote project path and node # binary. Health check: GET http://127.0.0.1:8081/health. restart_agent_runtime() { step "Restarting agent-runtime on :8081 (systemd user unit)" remote bash -s -- "$REMOTE_DIR" <<'REMOTE' set -euo pipefail remote_dir=$1 node_bin=$(command -v node || true) if [[ -z "$node_bin" ]]; then echo "node not found on remote PATH" >&2 exit 1 fi mkdir -p ~/.config/systemd/user sed -e "s|@APP_DIR@|$remote_dir|g" -e "s|@NODE@|$node_bin|g" \ "$remote_dir/scripts/systemd/local-studio-agent-runtime.service" \ > ~/.config/systemd/user/local-studio-agent-runtime.service systemctl --user daemon-reload systemctl --user enable --now local-studio-agent-runtime.service >/dev/null 2>&1 || true systemctl --user restart local-studio-agent-runtime.service REMOTE wait_port 8081 agent-runtime 15 || return 1 if remote "curl -sf -m 3 http://127.0.0.1:8081/health >/dev/null"; then ok "agent-runtime :8081 healthy" else fail "agent-runtime :8081 /health failed" remote "journalctl --user -u local-studio-agent-runtime -n 20 --no-pager" 2>/dev/null || true return 1 fi } restart_controller() { step "Restarting controller on :8080" remote bash -s -- "$REMOTE_DIR" <<'REMOTE' set -euo pipefail remote_dir=$1 cd "$remote_dir" for controller_service in local-studio-controller-8080.service vllm-studio-controller-b70.service vllm-studio-controller.service; do if systemctl --user is-active "$controller_service" >/dev/null 2>&1; then systemctl --user restart "$controller_service" exit 0 fi done docker compose stop controller 2>/dev/null || true controller_dir=$(readlink -f "$PWD/controller") collect_controller_pids() { { port_pids=$(fuser 8080/tcp 2>/dev/null || true) for pid in $port_pids; do echo "$pid" done for pid in $(pgrep -x bun 2>/dev/null || true); do cwd=$(readlink -f "/proc/$pid/cwd" 2>/dev/null || true) if [[ "$cwd" == "$controller_dir" ]]; then echo "$pid" fi done } | sed '/^$/d' | sort -n -u } controller_pids=$(collect_controller_pids) if [[ -n "$controller_pids" ]]; then while read -r pid; do [[ -n "$pid" ]] && kill -TERM "$pid" 2>/dev/null || true done <<< "$controller_pids" for _ in $(seq 1 20); do if [[ -z "$(collect_controller_pids)" ]] && ! ss -tlnp | grep -q ':8080\b'; then break fi sleep 0.25 done controller_pids=$(collect_controller_pids) if [[ -n "$controller_pids" ]]; then while read -r pid; do [[ -n "$pid" ]] && kill -KILL "$pid" 2>/dev/null || true done <<< "$controller_pids" sleep 1 fi fi if ss -tlnp | grep -q ':8080\b'; then echo "Port 8080 is still in use after stopping controller processes" >&2 ss -tlnp | grep ':8080\b' >&2 || true exit 1 fi sleep 1 set -a; source .env 2>/dev/null || true; set +a : > /tmp/controller-stdout.log nohup ~/.bun/bin/bun run controller/src/main.ts > /tmp/controller-stdout.log 2>&1 & REMOTE wait_port 8080 controller || return 1 local controller_pid controller_pid=$(remote "ss -tlnp | sed -n 's/.*:8080\\b.*pid=\\([0-9][0-9]*\\).*/\\1/p' | head -1" 2>/dev/null || true) ok "controller :8080 (pid ${controller_pid:-?})" } restart_frontend() { step "Restarting frontend on :3000" remote bash -s -- "$REMOTE_DIR" <<'REMOTE' set -euo pipefail remote_dir=$1 frontend_service=vllm-studio-frontend.service restart_managed_frontend() { local unit_file="$HOME/.config/systemd/user/$frontend_service" local drop_in_dir="${unit_file}.d" local drop_in systemctl --user cat "$frontend_service" >/dev/null 2>&1 || return 1 [[ -f "$unit_file" ]] || return 1 systemctl --user stop "$frontend_service" || return 1 sed -i \ 's/vllm-studio-controller\.service/local-studio-controller-8080.service/g' \ "$unit_file" || return 1 for drop_in in "$drop_in_dir"/*.conf; do [[ -f "$drop_in" ]] || continue sed -i \ 's/vllm-studio-controller\.service/local-studio-controller-8080.service/g' \ "$drop_in" || return 1 done rm -f "$drop_in_dir/zz-local-studio-controller.conf" systemctl --user daemon-reload || return 1 systemctl --user disable --now \ vllm-studio-controller.service \ vllm-studio-controller-b70.service >/dev/null 2>&1 || true fuser -k 3000/tcp >/dev/null 2>&1 || true systemctl --user restart "$frontend_service" } restart_detached_frontend() { cd "$remote_dir/frontend" docker compose -f "$remote_dir/docker-compose.yml" stop frontend 2>/dev/null || true pkill -f "next start" 2>/dev/null || true pkill -f "next dev" 2>/dev/null || true fuser -k 3000/tcp >/dev/null 2>&1 || true sleep 1 export BACKEND_URL=http://localhost:8080 export LOCAL_STUDIO_AGENT_RUNTIME_URL=http://127.0.0.1:8081 nohup node scripts/start-standalone.mjs > /tmp/frontend-stdout.log 2>&1 & } restart_managed_frontend || restart_detached_frontend REMOTE wait_port 3000 frontend 15 || return 1 ok "frontend :3000 (production)" } # ─── Infra ──────────────────────────────────────────────────────────────── start_infra() { step "Starting Docker infra" remote "cd $REMOTE_DIR_SHELL && docker compose stop litellm 2>/dev/null || true" remote "cd $REMOTE_DIR_SHELL && docker compose up -d postgres 2>&1 | tail -5" ok "postgres :5432" } # ─── Status / diagnostics ──────────────────────────────────────────────── show_status() { step "Status" echo "" remote "cd $REMOTE_DIR_SHELL && bash" <<'REMOTE' _g='\033[32m' _r='\033[31m' _d='\033[2m' _n='\033[0m' if [[ -f .env ]]; then set -a # shellcheck disable=SC1091 source .env set +a fi auth_headers=() if [[ -n "${LOCAL_STUDIO_API_KEY:-}" ]]; then auth_headers=(-H "Authorization: Bearer ${LOCAL_STUDIO_API_KEY}") fi probe() { local label="$1" url="$2" local code code=$(curl -s -m 3 -o /dev/null -w "%{http_code}" "$url" 2>/dev/null || echo 000) if [[ "$code" =~ ^2 ]]; then printf " ${_g}%-22s${_n} %s\n" "$label" ":$3 OK" else printf " ${_r}%-22s${_n} %s\n" "$label" ":$3 ($code)" fi } probe "controller" http://localhost:8080/health 8080 probe "agent-runtime" http://localhost:8081/health 8081 probe "frontend" http://localhost:3000 3000 probe "frontend→proxy" http://localhost:3000/api/proxy/health 3000 probe "vllm" http://localhost:8000/v1/models 8000 # Services that need port checks instead of HTTP probes for pair in "postgres:5432"; do label="${pair%%:*}" port="${pair##*:}" if ss -tlnp 2>/dev/null | grep -q ":${port}\b"; then printf " ${_g}%-22s${_n} %s\n" "$label" ":$port OK" else printf " ${_r}%-22s${_n} %s\n" "$label" ":$port down" fi done echo "" # GPU table gpus=$(curl -s http://localhost:8080/gpus 2>/dev/null) if echo "$gpus" | python3 -c " import sys,json d=json.load(sys.stdin) if not d.get('gpus'): sys.exit(1) for g in d['gpus']: pct = g['memory_used_mb'] / g['memory_total_mb'] * 100 print(f' GPU {g[\"index\"]} {g[\"name\"]:30s} {g[\"memory_used_mb\"]:>5d}/{g[\"memory_total_mb\"]}MB ({pct:4.0f}%) {g[\"temp_c\"]:>2d}°C {g[\"power_draw\"]:>6.1f}W') " 2>/dev/null; then echo "" fi # Running model curl -s "${auth_headers[@]}" http://localhost:8080/status 2>/dev/null | python3 -c " import sys,json d=json.load(sys.stdin) if d.get('running'): p=d['process'] print(f' Model: {p[\"served_model_name\"]} ({p[\"backend\"]}, pid {p[\"pid\"]}, :{p[\"port\"]})') else: print(' Model: (none)') " 2>/dev/null || true REMOTE } # ─── Commands ───────────────────────────────────────────────────────────── case "${1:-}" in controller) sync_controller; sync_shared; install_controller; restart_controller echo ""; show_status ;; frontend) sync_frontend; install_frontend; build_frontend_local; restart_frontend echo ""; show_status ;; agent-runtime) sync_shared; sync_services; build_agent_runtime; restart_agent_runtime echo ""; show_status ;; infra) sync_config; start_infra ;; status) show_status ;; ""|all) sync_all install_controller; install_frontend start_infra restart_controller build_agent_runtime; restart_agent_runtime build_frontend_local; restart_frontend echo ""; show_status ;; *) echo "Usage: $(basename "$0") [all|controller|frontend|agent-runtime|infra|status]" exit 1 ;; esac