letfixit 0.1.0

package/setup.sh

@@ -0,0 +1,160 @@
+#!/bin/bash
+set -e
+
+BOLD='\033[1m'
+GREEN='\033[0;32m'
+CYAN='\033[0;36m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+RESET='\033[0m'
+
+# ── Paths ─────────────────────────────────────────────────────────────────────
+MODEL_DIR="./bin/nemotron"
+MODEL_PATH="$MODEL_DIR/model.gguf"
+
+# Nemotron-3-Nano-4B-Coding-Agent Q4_K_M GGUF (~2.4 GB)
+# Primary source: HuggingFace (public, no auth required)
+HF_MODEL_URL="https://huggingface.co/S4MPL3BI4S/Nemotron-3-Nano-4B-Coding-Agent-GGUF/resolve/main/Nemotron-3-Nano-4B-Coding-Agent.Q4_K_M.gguf"
+
+# Optional team cache: set GDRIVE_MODEL_ID in .env or environment to a
+# Google Drive file ID so teammates skip the HuggingFace download.
+# Share the file publicly (Anyone with link → Viewer) before setting the ID.
+GDRIVE_MODEL_ID="${GDRIVE_MODEL_ID:-}"
+
+echo ""
+echo -e "${BOLD}🔍 Perf Analyzer v0.1.0 — Setup${RESET}"
+echo "────────────────────────────────────────────"
+
+# ── 1. Server dependencies ────────────────────────────────────────────────────
+echo -e "\n${CYAN}[1/6] Installing server dependencies...${RESET}"
+cd server && npm install --silent && cd ..
+echo -e "${GREEN}      ✅ Server ready${RESET}"
+
+# ── 2. Dashboard dependencies ─────────────────────────────────────────────────
+echo -e "\n${CYAN}[2/6] Installing dashboard dependencies...${RESET}"
+cd dashboard && npm install --silent && cd ..
+echo -e "${GREEN}      ✅ Dashboard dependencies ready${RESET}"
+
+# ── 3. Build dashboard ────────────────────────────────────────────────────────
+echo -e "\n${CYAN}[3/6] Building dashboard...${RESET}"
+cd dashboard && npm run build --silent && cd ..
+echo -e "${GREEN}      ✅ Dashboard built → dashboard/dist/${RESET}"
+
+# ── 4. Copy .env ──────────────────────────────────────────────────────────────
+echo -e "\n${CYAN}[4/6] Setting up environment...${RESET}"
+if [ ! -f .env ]; then
+  cp .env.example .env
+  echo -e "${GREEN}      ✅ Created .env from .env.example${RESET}"
+else
+  echo -e "${YELLOW}      ⚠️  .env already exists — skipped (edit it manually to change settings)${RESET}"
+fi
+
+# ── 5. llama.cpp server (llama-server) ───────────────────────────────────────
+echo -e "\n${CYAN}[5/6] Setting up llama-server (llama.cpp)...${RESET}"
+
+if command -v llama-server &>/dev/null; then
+  echo -e "${YELLOW}      ⚠️  llama-server already installed — skipped${RESET}"
+  llama-server --version 2>&1 | head -1 | sed 's/^/      ↳ /'
+else
+  echo -e "      📥 Installing llama.cpp (llama-server)..."
+  curl -LsSf https://llama.app/install.sh | sh
+  if command -v llama-server &>/dev/null; then
+    echo -e "${GREEN}      ✅ llama-server installed${RESET}"
+    llama-server --version 2>&1 | head -1 | sed 's/^/      ↳ /'
+  else
+    echo -e "${RED}      ❌ llama-server install failed — install manually:${RESET}"
+    echo -e "         curl -LsSf https://llama.app/install.sh | sh"
+    echo -e "${YELLOW}      ↳ Continuing without local AI — cloud API fallback will be used.${RESET}"
+  fi
+fi
+
+# ── 6. Nemotron-3-Nano-4B model ───────────────────────────────────────────────
+echo -e "\n${CYAN}[6/6] Setting up local AI model (Nemotron-3-Nano-4B)...${RESET}"
+mkdir -p "$MODEL_DIR"
+
+if [ -f "$MODEL_PATH" ] && [ "$(stat -f%z "$MODEL_PATH" 2>/dev/null || stat -c%s "$MODEL_PATH" 2>/dev/null)" -gt 104857600 ]; then
+  echo -e "${YELLOW}      ⚠️  Nemotron model already downloaded — skipped${RESET}"
+else
+  # ── Try Google Drive team cache first (fastest if your team set this up) ──
+  if [ -n "$GDRIVE_MODEL_ID" ]; then
+    echo -e "      📥 Trying Google Drive team cache (GDRIVE_MODEL_ID is set)..."
+    if command -v gdown &>/dev/null; then
+      if gdown "https://drive.google.com/uc?id=${GDRIVE_MODEL_ID}" -O "$MODEL_PATH" 2>&1; then
+        chmod +x "$MODEL_PATH"
+        echo -e "${GREEN}      ✅ Nemotron downloaded from Google Drive → $MODEL_PATH${RESET}"
+        SKIP_HF=true
+      else
+        echo -e "${YELLOW}      ⚠️  Google Drive download failed — falling back to HuggingFace${RESET}"
+      fi
+    else
+      echo -e "      ℹ️  gdown not found — installing..."
+      if command -v pip3 &>/dev/null; then
+        pip3 install -q gdown
+        if gdown "https://drive.google.com/uc?id=${GDRIVE_MODEL_ID}" -O "$MODEL_PATH" 2>&1; then
+          chmod +x "$MODEL_PATH"
+          echo -e "${GREEN}      ✅ Nemotron downloaded from Google Drive → $MODEL_PATH${RESET}"
+          SKIP_HF=true
+        else
+          echo -e "${YELLOW}      ⚠️  Google Drive download failed — falling back to HuggingFace${RESET}"
+        fi
+      else
+        echo -e "${YELLOW}      ⚠️  pip3 not found — cannot install gdown, falling back to HuggingFace${RESET}"
+      fi
+    fi
+  fi
+
+  # ── HuggingFace direct download (no account needed, public model) ──────────
+  if [ "${SKIP_HF:-false}" != "true" ]; then
+    echo -e "      📥 Downloading Nemotron-3-Nano-4B Q4_K_M from HuggingFace (~2.4 GB)..."
+    echo -e "      ℹ️  This is a one-time download. It will not repeat on future setups."
+    echo ""
+
+    # huggingface-cli is fastest if the user has it (handles resumable downloads)
+    if command -v huggingface-cli &>/dev/null; then
+      huggingface-cli download \
+        S4MPL3BI4S/Nemotron-3-Nano-4B-Coding-Agent-GGUF \
+        Nemotron-3-Nano-4B-Coding-Agent.Q4_K_M.gguf \
+        --local-dir "$MODEL_DIR" \
+        --local-dir-use-symlinks False
+      # huggingface-cli saves with original filename — rename to model.gguf
+      if [ -f "$MODEL_DIR/Nemotron-3-Nano-4B-Coding-Agent.Q4_K_M.gguf" ]; then
+        mv "$MODEL_DIR/Nemotron-3-Nano-4B-Coding-Agent.Q4_K_M.gguf" "$MODEL_PATH"
+      fi
+    else
+      curl -L --progress-bar -C - -o "$MODEL_PATH" "$HF_MODEL_URL"
+    fi
+
+    chmod +x "$MODEL_PATH"
+    echo -e "${GREEN}      ✅ Nemotron ready → $MODEL_PATH${RESET}"
+  fi
+fi
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}${GREEN}✅ Setup complete!${RESET}"
+echo ""
+echo -e "${BOLD}Quick start:${RESET}"
+echo ""
+echo -e "  ${CYAN}1. Run your Flutter app with VM service enabled:${RESET}"
+echo "     flutter run --vm-service-port=8181 --disable-service-auth-codes"
+echo ""
+echo -e "  ${CYAN}2. Start Perf Analyzer (it will ask for the VM port):${RESET}"
+echo "     npm start"
+echo "     └─ Starts Nemotron on :8080 + dashboard on :8081"
+echo ""
+echo -e "  ${CYAN}3. Add the Flutter adapter to your app's pubspec.yaml:${RESET}"
+echo "     perf_analyzer:"
+echo "       path: /path/to/perf_analyzer/adapters/flutter"
+echo ""
+echo -e "  ${CYAN}4. Initialize in main():${RESET}"
+echo "     await PerfAnalyzer.start();"
+echo ""
+echo -e "  ${CYAN}5. (Optional) Add cloud AI fallback keys to .env:${RESET}"
+echo "     GROQ_API_KEY, GEMINI_API_KEY, or CLAUDE_API_KEY"
+echo "     Nemotron runs locally by default — keys only used as fallback."
+echo ""
+echo -e "  ${BOLD}📊 Dashboard → http://localhost:8081${RESET}"
+echo ""
+echo -e "${YELLOW}  💡 Team tip: upload the model to Google Drive, set GDRIVE_MODEL_ID in .env,"
+echo -e "     and teammates will skip the HuggingFace download on future setups.${RESET}"
+echo ""