diff --git a/docs/NODE2_GUARDIAN_QUICKSTART.md b/docs/NODE2_GUARDIAN_QUICKSTART.md
new file mode 100644
index 00000000..061ec921
--- /dev/null
+++ b/docs/NODE2_GUARDIAN_QUICKSTART.md
@@ -0,0 +1,178 @@
+# Швидкий старт Node Guardian для НОДА2 (MacBook)
+
+## Крок 1: Перевірка доступності сервісів
+
+```bash
+# Перевірити чи Router доступний
+curl http://localhost:9102/health
+
+# Перевірити чи Swapper доступний
+curl http://localhost:8890/health
+```
+
+Якщо обидва повертають `{"status":"healthy"}`, продовжуйте.
+
+## Крок 2: Встановлення залежностей
+
+```bash
+cd /Users/apple/github-projects/microdao-daarion
+pip3 install httpx
+```
+
+## Крок 3: Запуск Node Guardian
+
+### Варіант А: Одноразовий запуск (для тестування)
+
+```bash
+cd /Users/apple/github-projects/microdao-daarion
+./scripts/start-node2-guardian.sh
+```
+
+### Варіант Б: Запуск у фоновому режимі (рекомендовано)
+
+```bash
+cd /Users/apple/github-projects/microdao-daarion
+
+# Запустити в фоні
+nohup ./scripts/start-node2-guardian.sh > /tmp/node-guardian.log 2>&1 &
+
+# Перевірити логи
+tail -f /tmp/node-guardian.log
+```
+
+### Варіант В: Запуск через launchd (macOS)
+
+Створіть файл `~/Library/LaunchAgents/com.daarion.node-guardian.plist`:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.daarion.node-guardian</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>/Users/apple/github-projects/microdao-daarion/scripts/node-guardian-loop.py</string>
+        <string>--node-id</string>
+        <string>node-2-macbook-m4max</string>
+        <string>--node-name</string>
+        <string>НОДА2</string>
+        <string>--city-url</string>
+        <string>https://daarion.space/api/city</string>
+        <string>--environment</string>
+        <string>development</string>
+        <string>--roles</string>
+        <string>gpu,ai_runtime</string>
+        <string>--hostname</string>
+        <string>$(hostname)</string>
+        <string>--interval</string>
+        <string>60</string>
+    </array>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>NODE_SWAPPER_URL</key>
+        <string>http://localhost:8890</string>
+        <key>NODE_ROUTER_URL</key>
+        <string>http://localhost:9102</string>
+    </dict>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/node-guardian.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/node-guardian-error.log</string>
+</dict>
+</plist>
+```
+
+Завантажити:
+
+```bash
+launchctl load ~/Library/LaunchAgents/com.daarion.node-guardian.plist
+launchctl start com.daarion.node-guardian
+```
+
+Перевірити статус:
+
+```bash
+launchctl list | grep node-guardian
+```
+
+## Крок 4: Перевірка роботи
+
+### Перевірити логи:
+
+```bash
+# Якщо запущено через nohup
+tail -f /tmp/node-guardian.log
+
+# Якщо через launchd
+tail -f /tmp/node-guardian.log /tmp/node-guardian-error.log
+```
+
+### Перевірити в БД (на сервері):
+
+```bash
+ssh root@144.76.224.179 "docker exec daarion-postgres psql -U postgres -d daarion -c \"SELECT node_id, swapper_healthy, swapper_models_total, router_healthy, last_heartbeat FROM node_cache WHERE node_id = 'node-2-macbook-m4max';\""
+```
+
+### Перевірити в UI:
+
+Відкрийте `https://daarion.space/nodes/node/node-2-macbook-m4max` та перевірте:
+- Swapper Service показує моделі ✅
+- DAGI Router показує статус "Up" ✅
+- Агенти відображаються в списку ✅
+
+## Troubleshooting
+
+### Guardian не запускається
+
+1. Перевірте чи Python 3 встановлений:
+   ```bash
+   python3 --version
+   ```
+
+2. Перевірте чи httpx встановлений:
+   ```bash
+   python3 -c "import httpx; print('OK')"
+   ```
+
+3. Перевірте чи сервіси доступні:
+   ```bash
+   curl http://localhost:9102/health
+   curl http://localhost:8890/health
+   ```
+
+### Guardian не оновлює метрики
+
+1. Перевірте з'єднання з city-service:
+   ```bash
+   curl -v https://daarion.space/api/city/health
+   ```
+
+2. Перевірте логи на помилки:
+   ```bash
+   tail -50 /tmp/node-guardian.log | grep -i error
+   ```
+
+3. Перевірте чи node_id правильний:
+   ```bash
+   # В логах має бути: Node ID: node-2-macbook-m4max
+   ```
+
+### Агенти не відображаються
+
+1. Перевірте чи агенти мають правильний node_id:
+   ```bash
+   ssh root@144.76.224.179 "docker exec daarion-postgres psql -U postgres -d daarion -c \"SELECT id, display_name, node_id FROM agents WHERE node_id = 'node-2-macbook-m4max';\""
+   ```
+
+2. Якщо потрібно оновити node_id для агентів:
+   ```bash
+   ./scripts/setup-node2-agents.sh
+   ```
+
diff --git a/scripts/setup-node2-agents.sh b/scripts/setup-node2-agents.sh
new file mode 100755
index 00000000..79dca415
--- /dev/null
+++ b/scripts/setup-node2-agents.sh
@@ -0,0 +1,29 @@
+#!/bin/bash
+# Setup agents for NODE2 - update node_id for agents that should be on NODE2
+
+set -e
+
+echo "🔧 Setting up agents for NODE2..."
+
+# List of agent IDs that should be on NODE2
+# You can modify this list based on your needs
+NODE2_AGENTS=(
+    "ag_atlas"
+    "ag_builder"
+    "ag_greeter"
+    "ag_oracle"
+)
+
+NODE_ID="node-2-macbook-m4max"
+
+# Update node_id for each agent
+for agent_id in "${NODE2_AGENTS[@]}"; do
+    echo "  Updating $agent_id to node_id=$NODE_ID..."
+    ssh root@144.76.224.179 "docker exec daarion-postgres psql -U postgres -d daarion -c \"UPDATE agents SET node_id = '$NODE_ID' WHERE id = '$agent_id' AND (node_id IS NULL OR node_id = '');\""
+done
+
+echo "✅ Agents updated for NODE2"
+echo ""
+echo "Verifying..."
+ssh root@144.76.224.179 "docker exec daarion-postgres psql -U postgres -d daarion -c \"SELECT id, display_name, node_id, status FROM agents WHERE node_id = '$NODE_ID' ORDER BY display_name;\""
+
diff --git a/scripts/start-node2-guardian.sh b/scripts/start-node2-guardian.sh
new file mode 100755
index 00000000..7e516590
--- /dev/null
+++ b/scripts/start-node2-guardian.sh
@@ -0,0 +1,50 @@
+#!/bin/bash
+# Start Node Guardian for NODE2 (MacBook)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+cd "$PROJECT_ROOT"
+
+# Check if Python 3 is available
+if ! command -v python3 &> /dev/null; then
+    echo "❌ Python 3 is not installed"
+    exit 1
+fi
+
+# Check if httpx is installed
+if ! python3 -c "import httpx" 2>/dev/null; then
+    echo "⚠️  httpx not installed. Installing..."
+    pip3 install httpx
+fi
+
+# Set environment variables
+export NODE_ID="node-2-macbook-m4max"
+export NODE_NAME="НОДА2"
+export NODE_ENVIRONMENT="development"
+export NODE_ROLES="gpu,ai_runtime"
+export NODE_HOSTNAME="$(hostname)"
+export CITY_SERVICE_URL="https://daarion.space/api/city"
+export NODE_SWAPPER_URL="http://localhost:8890"
+export NODE_ROUTER_URL="http://localhost:9102"
+export GUARDIAN_INTERVAL="60"
+
+echo "🚀 Starting Node Guardian for NODE2..."
+echo "   Node ID: $NODE_ID"
+echo "   City Service: $CITY_SERVICE_URL"
+echo "   Swapper URL: $NODE_SWAPPER_URL"
+echo "   Router URL: $NODE_ROUTER_URL"
+echo ""
+
+# Run node-guardian-loop
+python3 "$PROJECT_ROOT/scripts/node-guardian-loop.py" \
+    --node-id "$NODE_ID" \
+    --node-name "$NODE_NAME" \
+    --city-url "$CITY_SERVICE_URL" \
+    --environment "$NODE_ENVIRONMENT" \
+    --roles "$NODE_ROLES" \
+    --hostname "$NODE_HOSTNAME" \
+    --interval "$GUARDIAN_INTERVAL"
+