@allanpk716/work-skills-setup 0.1.0

package/src/detectors/python.js

@@ -0,0 +1,48 @@
+'use strict';
+
+const execa = require('execa');
+
+/**
+ * Detect Python installation and version
+ * @returns {Promise<{name: string, installed: boolean, version: string|null, meetsMinimum: boolean, command: string|null, guidance: string}>}
+ */
+async function detectPython() {
+  const commands = ['python', 'python3', 'py'];
+
+  for (const cmd of commands) {
+    try {
+      const { stdout } = await execa(cmd, ['--version'], { reject: false });
+
+      if (stdout && stdout.includes('Python')) {
+        const versionMatch = stdout.match(/Python (\d+\.\d+\.\d+)/i);
+
+        if (versionMatch) {
+          const version = versionMatch[1];
+          const [major, minor] = version.split('.').map(Number);
+
+          return {
+            name: 'Python',
+            command: cmd,
+            installed: true,
+            version,
+            meetsMinimum: major > 3 || (major === 3 && minor >= 8),
+            guidance: 'guidance.installPython'
+          };
+        }
+      }
+    } catch {
+      // Try next command
+    }
+  }
+
+  return {
+    name: 'Python',
+    command: null,
+    installed: false,
+    version: null,
+    meetsMinimum: false,
+    guidance: 'guidance.installPython'
+  };
+}
+
+module.exports = { detectPython };

package/src/detectors/ssh-tools.js

@@ -0,0 +1,94 @@
+/**
+ * SSH Tools Detector
+ * Detects TortoiseGit and PuTTY via Windows registry
+ */
+
+const Registry = require('winreg');
+
+/**
+ * Check if TortoiseGit is installed via registry
+ * @returns {Promise<{installed: boolean}>}
+ */
+async function detectTortoiseGit() {
+  return new Promise((resolve) => {
+    const regKey = new Registry({
+      hive: Registry.HKLM,
+      key: '\\Software\\TortoiseGit'
+    });
+
+    regKey.valueExists('', (err, exists) => {
+      if (err || !exists) {
+        // Try 32-bit path on 64-bit Windows
+        const regKey32 = new Registry({
+          hive: Registry.HKLM,
+          key: '\\Software\\Wow6432Node\\TortoiseGit'
+        });
+        regKey32.valueExists('', (err2, exists2) => {
+          resolve({ installed: !err2 && exists2 });
+        });
+      } else {
+        resolve({ installed: true });
+      }
+    });
+  });
+}
+
+/**
+ * Check if PuTTY is installed via registry
+ * @returns {Promise<{installed: boolean}>}
+ */
+async function detectPuTTY() {
+  return new Promise((resolve) => {
+    const regKey = new Registry({
+      hive: Registry.HKCU,
+      key: '\\Software\\SimonTatham\\PuTTY'
+    });
+
+    regKey.keyExists((err, exists) => {
+      resolve({ installed: !err && exists });
+    });
+  });
+}
+
+/**
+ * Check if any SSH tool (TortoiseGit or PuTTY) is installed
+ * @returns {Promise<{name: string, installed: boolean, version: null, meetsMinimum: boolean, details: object, message: string, guidance: string}>}
+ */
+async function detectSSHTools() {
+  const [tortoiseGit, putty] = await Promise.all([
+    detectTortoiseGit(),
+    detectPuTTY()
+  ]);
+
+  const installed = tortoiseGit.installed || putty.installed;
+
+  let message;
+  if (tortoiseGit.installed && putty.installed) {
+    message = 'Both TortoiseGit and PuTTY installed';
+  } else if (tortoiseGit.installed) {
+    message = 'TortoiseGit installed';
+  } else if (putty.installed) {
+    message = 'PuTTY installed';
+  } else {
+    message = 'Neither TortoiseGit nor PuTTY found';
+  }
+
+  return {
+    name: 'SSH Tools',
+    installed,
+    version: null,
+    meetsMinimum: installed,
+    details: {
+      tortoiseGit: tortoiseGit.installed,
+      putty: putty.installed
+    },
+    message,
+    guidance: installed ? null : 'guidance.installSSHTools'
+  };
+}
+
+module.exports = {
+  detectSSHTools,
+  detectTortoiseGit,
+  detectPuTTY
+};

package/src/i18n/en.json

@@ -0,0 +1,112 @@
+{
+  "welcome.title": "Work Skills Setup",
+  "welcome.subtitle": "Claude Code skills installer for Windows developers",
+  "welcome.version": "Version",
+  "welcome.features": "Features",
+  "welcome.feature1": "Auto-configure environment",
+  "welcome.feature2": "Install required dependencies",
+  "welcome.feature3": "Setup Claude Code integration",
+  "error.windowsOnly": "This installer is designed for Windows only.",
+  "error.currentPlatform": "Current platform",
+  "cli.help.language": "Language (en/zh)",
+  "cli.help.noColor": "Disable colored output",
+  "detection.title": "Environment Detection",
+  "detection.checking": "Checking environment dependencies...",
+  "detection.summary": "Detection complete: {passed}/{total} passed",
+  "guidance.installPython": "Install Python 3.8+ from https://www.python.org/downloads/",
+  "guidance.installGit": "Install Git from https://git-scm.com/download/win",
+  "guidance.installTortoiseGit": "Install TortoiseGit from https://tortoisegit.org/download/",
+  "guidance.installPuTTY": "Install PuTTY from https://www.putty.org/",
+  "guidance.installSSHTools": "Install TortoiseGit or PuTTY for SSH authentication",
+  "guidance.installRequests": "Run: pip install requests",
+  "ssh.tortoiseGitFound": "TortoiseGit installed",
+  "ssh.puttyFound": "PuTTY installed",
+  "ssh.noneFound": "Neither TortoiseGit nor PuTTY found",
+  "install.missingFound": "Found {count} missing Python package(s):",
+  "install.promptInstall": "Install {package}?",
+  "install.installing": "Installing {package}...",
+  "install.success": "{package} installed successfully",
+  "install.failed": "Failed to install {package}",
+  "install.summary": "Installation Summary:",
+  "install.installed": "Installed",
+  "install.skipped": "Skipped",
+  "guidance.installPermission": "Run Command Prompt as Administrator, or use: pip install {package} --user",
+  "guidance.installNetwork": "Check your internet connection and try again",
+  "guidance.installPipNotFound": "pip not found. Reinstall Python with pip included",
+  "guidance.installUnknown": "Manual install: pip install {package}",
+  "config.summary": "Configuration Summary",
+  "config.status.configured": "Configured",
+  "config.status.skipped": "Skipped",
+  "config.status.failed": "Failed",
+  "config.section.pushover": "Pushover Notifications",
+  "config.section.gitSSH": "Git SSH Configuration",
+  "config.section.gitUser": "Git User Information",
+  "pushover.alreadyConfigured": "Pushover credentials already configured",
+  "pushover.promptReconfigure": "Reconfigure Pushover credentials?",
+  "pushover.promptConfigure": "Configure Pushover notifications?",
+  "pushover.promptToken": "Enter your Pushover application token:",
+  "pushover.promptUser": "Enter your Pushover user key:",
+  "pushover.validating": "Validating Pushover credentials...",
+  "pushover.validationFailed": "Pushover validation failed",
+  "pushover.retryPrompt": "Retry ({attempt}/{max})",
+  "pushover.saving": "Saving Pushover credentials...",
+  "pushover.saveFailed": "Failed to save Pushover credentials",
+  "pushover.configured": "Pushover configured successfully",
+  "pushover.currentSessionSet": "✓ Environment variables set for current session (immediate effect)",
+  "pushover.skipped": "Pushover configuration skipped",
+  "pushover.restartReminder": "Note: Restart your terminal for environment variables to persist in future sessions",
+  "guidance.pushoverManual": "Manually set environment variables:\n  setx PUSHOVER_TOKEN \"your-token\"\n  setx PUSHOVER_USER \"your-user\"",
+  "gitSSH.configured": "Git SSH is configured",
+  "gitSSH.notConfigured": "Git SSH is not configured",
+  "gitSSH.recommended": "SSH is recommended for Git remote operations",
+  "gitSSH.guidance": "Configuration steps:",
+  "gitSSH.step1": "1. Install TortoiseGit (includes Pageant)",
+  "gitSSH.step2": "2. Generate SSH key (e.g., using PuTTYgen)",
+  "gitSSH.step3": "3. Add public key to remote repository (GitHub/GitLab)",
+  "gitSSH.step4": "4. Configure Git to use TortoiseGit SSH:",
+  "gitSSH.command": "   git config --global core.sshCommand \"C:/Program Files/TortoiseGit/bin/TortoisePlink.exe\"",
+  "gitSSH.docs": "Documentation: https://work-skills.example.com/docs/git-ssh-setup",
+  "gitSSH.promptSkip": "Skip Git SSH configuration? (You can use HTTPS instead)",
+  "gitSSH.skipped": "Git SSH configuration skipped",
+  "gitUser.alreadyConfigured": "Git user information already configured",
+  "gitUser.required": "Git user information is required for commits",
+  "gitUser.promptName": "Enter your Git username (for commits):",
+  "gitUser.promptEmail": "Enter your Git email address:",
+  "gitUser.configured": "Git user information configured",
+  "gitUser.failed": "Failed to configure Git user information",
+  "marketplace.title": "Plugin Marketplace",
+  "marketplace.registering": "Registering work-skills marketplace source...",
+  "marketplace.registered": "Marketplace source 'work-skills' added successfully",
+  "marketplace.fetching": "Fetching available plugins...",
+  "marketplace.available": "Available Plugins:",
+  "marketplace.select_plugins": "Which plugins would you like to install?",
+  "marketplace.none_selected": "No plugins selected. You can install them later.",
+  "marketplace.checking": "Checking installed plugins...",
+  "marketplace.already_installed": "{name} (already installed, will skip)",
+  "marketplace.installing": "Installing {name}...",
+  "marketplace.install_success": "{name} installed successfully",
+  "marketplace.install_skipped": "{name} skipped (already installed)",
+  "marketplace.install_failed": "{name} installation failed",
+  "marketplace.summary": "Plugin Installation Summary:",
+  "marketplace.summary_installed": "Installed: {count}",
+  "marketplace.summary_skipped": "Skipped: {count}",
+  "marketplace.summary_failed": "Failed: {count}",
+  "marketplace.complete": "Plugin installation complete. Run Claude Code to use them.",
+  "marketplace.error.network": "Failed to fetch plugin list. Check your network connection.",
+  "marketplace.error.git": "Git is required to install plugins.",
+  "marketplace.error.unknown": "An error occurred during marketplace integration.",
+  "installation.complete": "=== Installation Complete ===",
+  "installation.verificationStarting": "Running verification to check your setup...",
+  "verification.title": "Installation Verification",
+  "verification.summary": "Summary: {passed}/{total} checks passed",
+  "verification.rerunCommand": "To re-run verification: npx github:allanpk716/work-skills#main --verify",
+  "verification.error.pythonNotFound": "Error: Python is required for verification",
+  "verification.error.scriptNotFound": "Error: Verification script not found",
+  "verification.error.timeout": "Error: Verification timeout (30s)",
+  "verification.error.executionFailed": "Error: Verification failed",
+  "verification.nextSteps": "Next Steps",
+  "verification.nextStep1": "1. If this is your first time: Close and reopen your terminal",
+  "verification.nextStep2": "2. Start Claude Code in any project directory",
+  "verification.nextStep3": "3. Available skills: /windows-git-commit, /notify-test",
+  "verification.nextStep4": "4. Or just say: 'Use windows-git-commit to commit my changes'"
+}

package/src/i18n/index.js

@@ -0,0 +1,70 @@
+'use strict';
+
+const en = require('./en.json');
+const zh = require('./zh.json');
+
+const translations = { en, zh };
+
+let currentLang = null;
+
+/**
+ * Detect system language
+ * @returns {'en'|'zh'}
+ */
+function detectLanguage() {
+  const langEnv = process.env.LANG || process.env.LC_ALL || '';
+  const languageEnv = process.env.LANGUAGE || '';
+  const lcCtype = process.env.LC_CTYPE || '';
+
+  // Check for Chinese language environment
+  if (langEnv.toLowerCase().startsWith('zh') ||
+      languageEnv.toLowerCase().includes('zh') ||
+      lcCtype.toLowerCase().startsWith('zh')) {
+    return 'zh';
+  }
+
+  return 'en';
+}
+
+/**
+ * Get current language (auto-detect or manually set)
+ * @returns {'en'|'zh'}
+ */
+function getLanguage() {
+  return currentLang || detectLanguage();
+}
+
+/**
+ * Set language manually (overrides auto-detection)
+ * @param {'en'|'zh'|null} lang
+ */
+function setLanguage(lang) {
+  if (lang === 'en' || lang === 'zh' || lang === null) {
+    currentLang = lang;
+  }
+}
+
+/**
+ * Translate a key
+ * @param {string} key - Translation key
+ * @param {Object} params - Parameters to replace in translation string
+ * @returns {string} - Translated string with parameters replaced
+ */
+function t(key, params = {}) {
+  const lang = getLanguage();
+  let translation = translations[lang]?.[key] || translations['en'][key] || key;
+
+  // Replace {param} with actual values
+  Object.keys(params).forEach(param => {
+    translation = translation.replace(new RegExp(`\\{${param}\\}`, 'g'), params[param]);
+  });
+
+  return translation;
+}
+
+module.exports = {
+  t,
+  detectLanguage,
+  getLanguage,
+  setLanguage
+};

package/src/i18n/zh.json

@@ -0,0 +1,112 @@
+{
+  "welcome.title": "Work Skills 安装器",
+  "welcome.subtitle": "为 Windows 开发者准备的 Claude Code 技能安装工具",
+  "welcome.version": "版本",
+  "welcome.features": "功能特性",
+  "welcome.feature1": "自动配置环境",
+  "welcome.feature2": "安装必需依赖",
+  "welcome.feature3": "配置 Claude Code 集成",
+  "error.windowsOnly": "此安装器仅支持 Windows 系统。",
+  "error.currentPlatform": "当前系统",
+  "cli.help.language": "语言 (en/zh)",
+  "cli.help.noColor": "禁用彩色输出",
+  "detection.title": "环境检测",
+  "detection.checking": "正在检查环境依赖...",
+  "detection.summary": "检测完成: {passed}/{total} 项通过",
+  "guidance.installPython": "从 https://www.python.org/downloads/ 安装 Python 3.8+",
+  "guidance.installGit": "从 https://git-scm.com/download/win 安装 Git",
+  "guidance.installTortoiseGit": "从 https://tortoisegit.org/download/ 安装 TortoiseGit",
+  "guidance.installPuTTY": "从 https://www.putty.org/ 安装 PuTTY",
+  "guidance.installSSHTools": "安装 TortoiseGit 或 PuTTY 用于 SSH 认证",
+  "guidance.installRequests": "运行: pip install requests",
+  "ssh.tortoiseGitFound": "已安装 TortoiseGit",
+  "ssh.puttyFound": "已安装 PuTTY",
+  "ssh.noneFound": "未找到 TortoiseGit 或 PuTTY",
+  "install.missingFound": "发现 {count} 个缺失的 Python 包:",
+  "install.promptInstall": "是否安装 {package}?",
+  "install.installing": "正在安装 {package}...",
+  "install.success": "{package} 安装成功",
+  "install.failed": "{package} 安装失败",
+  "install.summary": "安装摘要:",
+  "install.installed": "已安装",
+  "install.skipped": "已跳过",
+  "guidance.installPermission": "以管理员身份运行命令提示符,或使用: pip install {package} --user",
+  "guidance.installNetwork": "请检查网络连接后重试",
+  "guidance.installPipNotFound": "pip 未找到。请重新安装包含 pip 的 Python",
+  "guidance.installUnknown": "手动安装: pip install {package}",
+  "config.summary": "配置摘要",
+  "config.status.configured": "已配置",
+  "config.status.skipped": "已跳过",
+  "config.status.failed": "失败",
+  "config.section.pushover": "Pushover 通知",
+  "config.section.gitSSH": "Git SSH 配置",
+  "config.section.gitUser": "Git 用户信息",
+  "pushover.alreadyConfigured": "Pushover 凭证已配置",
+  "pushover.promptReconfigure": "是否重新配置 Pushover 凭证?",
+  "pushover.promptConfigure": "是否配置 Pushover 通知?",
+  "pushover.promptToken": "请输入 Pushover 应用 token:",
+  "pushover.promptUser": "请输入 Pushover 用户 key:",
+  "pushover.validating": "正在验证 Pushover 凭证...",
+  "pushover.validationFailed": "Pushover 验证失败",
+  "pushover.retryPrompt": "重试 ({attempt}/{max})",
+  "pushover.saving": "正在保存 Pushover 凭证...",
+  "pushover.saveFailed": "Pushover 凭证保存失败",
+  "pushover.configured": "Pushover 配置成功",
+  "pushover.currentSessionSet": "✓ 已为当前会话设置环境变量，立即生效",
+  "pushover.skipped": "Pushover 配置已跳过",
+  "pushover.restartReminder": "注意: 需要重启终端才能使环境变量在后续会话中生效",
+  "guidance.pushoverManual": "手动设置环境变量:\n  setx PUSHOVER_TOKEN \"your-token\"\n  setx PUSHOVER_USER \"your-user\"",
+  "gitSSH.configured": "Git SSH 已配置",
+  "gitSSH.notConfigured": "Git SSH 未配置",
+  "gitSSH.recommended": "建议配置 SSH 以使用 Git 远程操作",
+  "gitSSH.guidance": "配置 Git SSH 步骤:",
+  "gitSSH.step1": "1. 安装 TortoiseGit (包含 Pageant)",
+  "gitSSH.step2": "2. 生成 SSH 密钥 (如使用 PuTTYgen)",
+  "gitSSH.step3": "3. 将公钥添加到远程仓库 (GitHub/GitLab)",
+  "gitSSH.step4": "4. 配置 Git 使用 TortoiseGit 的 SSH:",
+  "gitSSH.command": "   git config --global core.sshCommand \"C:/Program Files/TortoiseGit/bin/TortoisePlink.exe\"",
+  "gitSSH.docs": "详细文档: https://work-skills.example.com/docs/git-ssh-setup",
+  "gitSSH.promptSkip": "跳过 Git SSH 配置? (可使用 HTTPS)",
+  "gitSSH.skipped": "Git SSH 配置已跳过",
+  "gitUser.alreadyConfigured": "Git 用户信息已配置",
+  "gitUser.required": "Git 提交需要用户信息",
+  "gitUser.promptName": "请输入 Git 用户名 (用于提交记录):",
+  "gitUser.promptEmail": "请输入 Git 邮箱地址:",
+  "gitUser.configured": "Git 用户信息配置成功",
+  "gitUser.failed": "Git 用户信息配置失败",
+  "marketplace.title": "插件市场",
+  "marketplace.registering": "正在注册 work-skills 市场源...",
+  "marketplace.registered": "市场源 'work-skills' 添加成功",
+  "marketplace.fetching": "正在获取可用插件列表...",
+  "marketplace.available": "可用插件:",
+  "marketplace.select_plugins": "请选择要安装的插件:",
+  "marketplace.none_selected": "未选择任何插件。您可以稍后安装。",
+  "marketplace.checking": "正在检查已安装插件...",
+  "marketplace.already_installed": "{name} (已安装,将跳过)",
+  "marketplace.installing": "正在安装 {name}...",
+  "marketplace.install_success": "{name} 安装成功",
+  "marketplace.install_skipped": "{name} 已跳过 (已安装)",
+  "marketplace.install_failed": "{name} 安装失败",
+  "marketplace.summary": "插件安装摘要:",
+  "marketplace.summary_installed": "已安装: {count}",
+  "marketplace.summary_skipped": "已跳过: {count}",
+  "marketplace.summary_failed": "失败: {count}",
+  "marketplace.complete": "插件安装完成。运行 Claude Code 即可使用。",
+  "marketplace.error.network": "获取插件列表失败。请检查网络连接。",
+  "marketplace.error.git": "安装插件需要 Git。",
+  "marketplace.error.unknown": "市场集成过程中发生错误。",
+  "installation.complete": "=== 安装完成 ===",
+  "installation.verificationStarting": "正在运行验证以检查您的配置...",
+  "verification.title": "安装验证",
+  "verification.summary": "摘要: {passed}/{total} 项检查通过",
+  "verification.rerunCommand": "重新验证命令: npx github:allanpk716/work-skills#main --verify",
+  "verification.error.pythonNotFound": "错误: 验证需要 Python 环境",
+  "verification.error.scriptNotFound": "错误: 验证脚本未找到",
+  "verification.error.timeout": "错误: 验证超时 (30秒)",
+  "verification.error.executionFailed": "错误: 验证失败",
+  "verification.nextSteps": "后续步骤",
+  "verification.nextStep1": "1. 如果是首次安装: 关闭并重新打开终端",
+  "verification.nextStep2": "2. 在任意项目目录中启动 Claude Code",
+  "verification.nextStep3": "3. 可用技能: /windows-git-commit, /notify-test",
+  "verification.nextStep4": "4. 或直接说: '使用 windows-git-commit 提交我的修改'"
+}

package/src/index.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const { checkPlatform } = require('./platform.js');
+const { parseArgs } = require('./cli.js');
+const { showWelcome } = require('./welcome.js');
+const { runAllDetectors } = require('./detectors/index.js');
+const { runInstaller } = require('./installers/index.js');
+const { runAllConfigurators } = require('./configurators/index.js');
+const { runMarketplaceIntegration } = require('./marketplace/index.js');
+const { runVerification } = require('./verification/index.js');
+
+/**
+ * Main entry point for the installer
+ */
+async function main() {
+  // Step 1: Check platform (exits if not Windows)
+  checkPlatform();
+
+  // Step 2: Parse command line arguments
+  const options = parseArgs();
+
+  // Handle --verify flag (skip to verification only)
+  if (options.verifyOnly) {
+    const result = await runVerification();
+    process.exit(result.success ? 0 : 1);
+  }
+
+  // Step 3: Show welcome banner
+  showWelcome({ useColors: options.useColors });
+
+  // Step 4: Run environment detection
+  const { results, allPassed } = await runAllDetectors();
+
+  // Step 5: Offer to install missing dependencies
+  if (!allPassed) {
+    const pipResults = results.filter(r =>
+      r.name && r.name !== 'Python' && r.name !== 'Git' &&
+      !r.name.includes('TortoiseGit') && !r.name.includes('PuTTY') && !r.name.includes('SSH')
+    );
+
+    if (pipResults.some(r => !r.installed)) {
+      await runInstaller(results);
+    }
+  }
+
+  // Step 6: Interactive configuration (Phase 17)
+  await runAllConfigurators();
+
+  // Step 7: Marketplace integration (Phase 18)
+  await runMarketplaceIntegration();
+
+  // Step 8: Installation verification (Phase 19)
+  const chalk = require('chalk');
+  console.log(chalk.cyan('\n=== Installation Complete ===\n'));
+  console.log(chalk.gray('Running verification to check your setup...\n'));
+  await runVerification();
+}
+
+module.exports = {
+  main
+};

package/src/installers/index.js

@@ -0,0 +1,92 @@
+'use strict';
+
+const { Confirm } = require('enquirer');
+const chalk = require('chalk');
+const { t } = require('../i18n/index.js');
+const { installPipPackage, getErrorGuidance } = require('./pip-installer.js');
+
+/**
+ * Prompt user and install missing packages
+ * @param {Array} packages - Array of detection results
+ * @param {string} pythonCmd - Python command to use (default: 'python')
+ * @returns {Promise<{installed: Array, failed: Array, skipped: Array}>}
+ */
+async function promptAndInstall(packages, pythonCmd = 'python') {
+  const toInstall = packages.filter(p => !p.installed);
+
+  if (toInstall.length === 0) {
+    return { installed: [], failed: [], skipped: [] };
+  }
+
+  console.log(chalk.yellow('\n' + t('install.missingFound', { count: toInstall.length })));
+  toInstall.forEach(pkg => console.log(`  - ${pkg.name}`));
+
+  const installed = [];
+  const failed = [];
+  const skipped = [];
+
+  for (const pkg of toInstall) {
+    const prompt = new Confirm({
+      name: 'install',
+      message: t('install.promptInstall', { package: pkg.name }),
+      initial: true
+    });
+
+    const shouldInstall = await prompt.run();
+
+    if (shouldInstall) {
+      console.log(chalk.gray(t('install.installing', { package: pkg.name })));
+      const result = await installPipPackage(pkg.name, pythonCmd);
+
+      if (result.success) {
+        console.log(chalk.green('[OK] ' + result.message));
+        installed.push(pkg.name);
+      } else {
+        console.log(chalk.red('[FAIL] ' + result.message));
+        console.log(chalk.gray('    -> ' + t(getErrorGuidance(result.error))));
+        failed.push(pkg.name);
+      }
+    } else {
+      skipped.push(pkg.name);
+    }
+  }
+
+  return { installed, failed, skipped };
+}
+
+/**
+ * Run installer flow
+ * @param {Array} detectionResults - Results from environment detection
+ * @param {string} pythonCmd - Python command to use (default: 'python')
+ * @returns {Promise<{installed: Array, failed: Array, skipped: Array}>}
+ */
+async function runInstaller(detectionResults, pythonCmd = 'python') {
+  // Find Python detection result to get pythonCmd
+  const pythonResult = detectionResults.find(r => r.name === 'Python');
+  const cmd = pythonResult?.path || pythonCmd;
+
+  // Filter to get only pip packages (exclude system tools)
+  const pipPackages = detectionResults.filter(r =>
+    r.name &&
+    r.name !== 'Python' &&
+    r.name !== 'Git' &&
+    !r.name.includes('TortoiseGit') &&
+    !r.name.includes('PuTTY') &&
+    !r.name.includes('SSH')
+  );
+
+  const results = await promptAndInstall(pipPackages, cmd);
+
+  // Print summary
+  console.log('\n' + t('install.summary'));
+  console.log(chalk.green('  ' + t('install.installed') + ': ' + results.installed.length));
+  console.log(chalk.red('  ' + t('install.failed') + ': ' + results.failed.length));
+  console.log(chalk.gray('  ' + t('install.skipped') + ': ' + results.skipped.length));
+
+  return results;
+}
+
+module.exports = {
+  runInstaller,
+  promptAndInstall
+};

package/src/installers/pip-installer.js

@@ -0,0 +1,63 @@
+'use strict';
+
+const execa = require('execa');
+const chalk = require('chalk');
+const { t } = require('../i18n/index.js');
+
+/**
+ * Install a Python package using pip
+ * @param {string} packageName - Name of the package to install
+ * @param {string} pythonCmd - Python command to use (default: 'python')
+ * @returns {Promise<{success: boolean, message: string, output?: string, error?: string, errorDetails?: string}>}
+ */
+async function installPipPackage(packageName, pythonCmd = 'python') {
+  try {
+    const { stdout } = await execa(pythonCmd, ['-m', 'pip', 'install', packageName, '--user']);
+
+    return {
+      success: true,
+      message: t('install.success', { package: packageName }),
+      output: stdout
+    };
+  } catch (error) {
+    const stderr = error.stderr || error.message || '';
+    let errorType = 'unknown';
+
+    // Detect error type from stderr
+    if (stderr.includes('Permission denied') || stderr.includes('Access is denied')) {
+      errorType = 'permission';
+    } else if (stderr.toLowerCase().includes('network') || stderr.toLowerCase().includes('connection')) {
+      errorType = 'network';
+    } else if (stderr.includes('not found') || stderr.includes('ENOENT')) {
+      errorType = 'pipNotFound';
+    }
+
+    return {
+      success: false,
+      message: t('install.failed', { package: packageName }),
+      error: errorType,
+      errorDetails: stderr
+    };
+  }
+}
+
+/**
+ * Get guidance message key for an error type
+ * @param {string} errorType - Type of error
+ * @returns {string} - i18n key for guidance message
+ */
+function getErrorGuidance(errorType) {
+  const guidanceMap = {
+    'permission': 'guidance.installPermission',
+    'network': 'guidance.installNetwork',
+    'pipNotFound': 'guidance.installPipNotFound',
+    'unknown': 'guidance.installUnknown'
+  };
+
+  return guidanceMap[errorType] || guidanceMap['unknown'];
+}
+
+module.exports = {
+  installPipPackage,
+  getErrorGuidance
+};