gitinstall 1.1.0__tar.gz

gitinstall-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 icerui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gitinstall-1.1.0/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.4
+Name: gitinstall
+Version: 1.1.0
+Summary: MCP server & CLI that gives AI agents the ability to install any GitHub project — zero dependencies
+Author: icerui
+License: MIT
+Project-URL: Homepage, https://github.com/icerui/github-installer
+Project-URL: Repository, https://github.com/icerui/github-installer
+Project-URL: Issues, https://github.com/icerui/github-installer/issues
+Keywords: mcp,mcp-server,github,installer,ai-agent,claude,cursor,automation,devtools
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Installation/Setup
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# gitinstall
+
+<p align="center">
+  <strong>MCP server that gives AI agents the ability to install any GitHub project</strong><br/>
+  <em>让 AI Agent 拥有安装任何 GitHub 开源项目的能力</em>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://pypi.org/project/gitinstall"><img src="https://img.shields.io/pypi/v/gitinstall?style=for-the-badge" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/MCP-2024--11--05-blueviolet?style=for-the-badge" alt="MCP Protocol">
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen?style=for-the-badge" alt="Zero Dependencies">
+  <img src="https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows-green?style=for-the-badge" alt="Platforms">
+</p>
+
+<p align="center">
+  <b>Zero external dependencies</b> · Pure Python stdlib · Works without any LLM
+</p>
+
+---
+
+## The Problem
+
+AI agents can write code, explain errors, and suggest commands — but they **can't actually install software** on your machine. When you say "help me set up ComfyUI", the AI gives you a wall of commands and hopes for the best.
+
+**gitinstall** bridges this gap. It's an MCP server that gives any AI agent (Claude, Cursor, Copilot, etc.) the ability to:
+
+1. **Detect** your system (OS, GPU, runtimes, package managers)
+2. **Plan** the installation (30+ languages, 82 known projects)
+3. **Execute** safely (dangerous command blocking, no `rm -rf /`)
+4. **Auto-fix** errors (28 patterns: PEP 668, CUDA mismatch, missing tools...)
+5. **Retry** with fallback strategies if the first approach fails
+
+---
+
+## Quick Start
+
+### For Claude Desktop
+
+```bash
+pip install gitinstall
+```
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gitinstall": {
+      "command": "gitinstall-mcp"
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Now you can say:
+
+> "Help me install ComfyUI on this machine"
+
+Claude will call gitinstall's tools to detect your system, generate a plan, and execute it — with real-time progress updates and automatic error recovery.
+
+### For Cursor
+
+Add to Cursor's MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "gitinstall": {
+      "command": "gitinstall-mcp"
+    }
+  }
+}
+```
+
+### For VS Code (Copilot)
+
+Add to your VS Code `settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "gitinstall": {
+        "command": "gitinstall-mcp"
+      }
+    }
+  }
+}
+```
+
+### For any MCP client
+
+```bash
+gitinstall-mcp    # Starts MCP server on stdio (JSON-RPC 2.0)
+```
+
+---
+
+## MCP Tools
+
+gitinstall exposes 6 tools via MCP:
+
+| Tool | What it does |
+|------|-------------|
+| `install_github_project` | End-to-end installation: detect → plan → execute → auto-fix → fallback retry |
+| `diagnose_install_error` | Diagnose any build/install error and return fix commands (28 patterns) |
+| `detect_environment` | Report OS, CPU, GPU, runtimes, package managers, disk space |
+| `get_project_info` | Fetch GitHub project metadata without installing |
+| `check_system_health` | Full system diagnostic with fix suggestions |
+| `audit_dependencies` | Scan project dependencies for known CVEs |
+
+### Example: `install_github_project`
+
+The AI calls:
+```json
+{
+  "name": "install_github_project",
+  "arguments": {
+    "project": "comfyanonymous/ComfyUI"
+  }
+}
+```
+
+gitinstall handles everything:
+- Detects macOS Apple Silicon M3 + Python 3.12 + brew
+- Generates 3-step plan (clone → install PyTorch MPS → install deps)
+- Executes each step with safety checks
+- If `pip install` fails with PEP 668, auto-fixes with `python -m venv`
+- Returns success status + launch command
+
+### Example: `diagnose_install_error`
+
+The AI calls:
+```json
+{
+  "name": "diagnose_install_error",
+  "arguments": {
+    "stderr": "error: externally-managed-environment\n× This environment is externally managed",
+    "command": "pip install pandas"
+  }
+}
+```
+
+Returns:
+```json
+{
+  "root_cause": "System Python is protected (PEP 668), need virtual environment",
+  "fix_commands": ["python3 -m venv venv", "source venv/bin/activate"],
+  "confidence": "high"
+}
+```
+
+---
+
+## What makes it different
+
+### No LLM required
+
+The core engine is a **rule-based system**, not an AI wrapper:
+- 82 known projects have hand-crafted installation recipes
+- 30+ language templates (Python, Node, Rust, Go, C++, Haskell, Zig, Elixir...)
+- 28 error-fix rules covering real-world installation failures
+- LLM is optional — only used when the rule engine isn't confident
+
+### Zero dependencies
+
+```bash
+$ pip show gitinstall | grep Requires
+Requires:
+```
+
+Pure Python standard library. No `requests`, no `click`, no `rich`. One `pip install` and it works. No dependency conflicts, ever.
+
+### Safety built-in
+
+- **30+ dangerous command patterns blocked** (including base64/heredoc encoding bypass attempts)
+- **SSRF protection** on URL fetching (whitelist-only)
+- **No auto-sudo** — prompts explicitly when root needed
+- **Trusted failure detection** — stops retrying when the error is unfixable
+
+---
+
+## Also works as a CLI
+
+gitinstall works standalone too, no AI agent needed:
+
+```bash
+gitinstall comfyanonymous/ComfyUI     # Install a project
+gitinstall detect                      # Check your system
+gitinstall doctor                      # System diagnostic
+gitinstall audit pytorch/pytorch       # Security audit
+gitinstall plan neovim/neovim          # Preview install plan
+```
+
+---
+
+## Supported Languages & Platforms
+
+**Languages** (30+): Python, Node.js, TypeScript, Rust, Go, C, C++, Java, Kotlin, Scala, Swift, Ruby, PHP, Haskell, Zig, Elixir, Erlang, Clojure, Julia, Lua, Perl, R, Dart, .NET/C#, OCaml, Nim, V, Docker, Conda, CMake, Meson, Autotools, Bazel
+
+**Platforms**: macOS (Intel + Apple Silicon M1-M4), Ubuntu/Debian, Fedora/RHEL, Arch Linux, Windows 10/11, WSL2
+
+**GPU**: NVIDIA CUDA, AMD ROCm, Apple MPS, CPU fallback
+
+---
+
+## How It Works
+
+```
+User → AI Agent → MCP → gitinstall
+                         ├── detect   → OS / GPU / runtimes / package managers
+                         ├── fetch    → GitHub API → project type detection
+                         ├── plan     → SmartPlanner (known → template → README)
+                         ├── execute  → subprocess + safety filter + cd/venv tracking
+                         ├── fix      → 28 error patterns → auto-retry
+                         └── fallback → brew → cargo → source build
+```
+
+**SmartPlanner** has 3 tiers:
+1. **Known projects** (82): Hand-crafted recipes for popular projects (ComfyUI, Ollama, llama.cpp, Neovim...)
+2. **Language templates** (30+): Detect project type → apply template (handles Apple Silicon, CUDA, WSL2 edge cases)
+3. **README extraction**: Parse install commands from README (regex, or LLM if available)
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/icerui/github-installer.git
+cd github-installer
+
+# Run tests (2126 unit tests, zero external deps)
+python -m pytest tests/unit/ -q
+
+# Test MCP server
+python tests/test_mcp_server.py
+
+# Run locally
+python tools/mcp_server.py  # MCP server on stdio
+python tools/main.py detect # CLI mode
+```
+
+---
+
+## License
+
+MIT © icerui

gitinstall-1.1.0/README.md

@@ -0,0 +1,248 @@
+# gitinstall
+
+<p align="center">
+  <strong>MCP server that gives AI agents the ability to install any GitHub project</strong><br/>
+  <em>让 AI Agent 拥有安装任何 GitHub 开源项目的能力</em>
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://pypi.org/project/gitinstall"><img src="https://img.shields.io/pypi/v/gitinstall?style=for-the-badge" alt="PyPI"></a>
+  <img src="https://img.shields.io/badge/MCP-2024--11--05-blueviolet?style=for-the-badge" alt="MCP Protocol">
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen?style=for-the-badge" alt="Zero Dependencies">
+  <img src="https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows-green?style=for-the-badge" alt="Platforms">
+</p>
+
+<p align="center">
+  <b>Zero external dependencies</b> · Pure Python stdlib · Works without any LLM
+</p>
+
+---
+
+## The Problem
+
+AI agents can write code, explain errors, and suggest commands — but they **can't actually install software** on your machine. When you say "help me set up ComfyUI", the AI gives you a wall of commands and hopes for the best.
+
+**gitinstall** bridges this gap. It's an MCP server that gives any AI agent (Claude, Cursor, Copilot, etc.) the ability to:
+
+1. **Detect** your system (OS, GPU, runtimes, package managers)
+2. **Plan** the installation (30+ languages, 82 known projects)
+3. **Execute** safely (dangerous command blocking, no `rm -rf /`)
+4. **Auto-fix** errors (28 patterns: PEP 668, CUDA mismatch, missing tools...)
+5. **Retry** with fallback strategies if the first approach fails
+
+---
+
+## Quick Start
+
+### For Claude Desktop
+
+```bash
+pip install gitinstall
+```
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gitinstall": {
+      "command": "gitinstall-mcp"
+    }
+  }
+}
+```
+
+Restart Claude Desktop. Now you can say:
+
+> "Help me install ComfyUI on this machine"
+
+Claude will call gitinstall's tools to detect your system, generate a plan, and execute it — with real-time progress updates and automatic error recovery.
+
+### For Cursor
+
+Add to Cursor's MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "gitinstall": {
+      "command": "gitinstall-mcp"
+    }
+  }
+}
+```
+
+### For VS Code (Copilot)
+
+Add to your VS Code `settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "gitinstall": {
+        "command": "gitinstall-mcp"
+      }
+    }
+  }
+}
+```
+
+### For any MCP client
+
+```bash
+gitinstall-mcp    # Starts MCP server on stdio (JSON-RPC 2.0)
+```
+
+---
+
+## MCP Tools
+
+gitinstall exposes 6 tools via MCP:
+
+| Tool | What it does |
+|------|-------------|
+| `install_github_project` | End-to-end installation: detect → plan → execute → auto-fix → fallback retry |
+| `diagnose_install_error` | Diagnose any build/install error and return fix commands (28 patterns) |
+| `detect_environment` | Report OS, CPU, GPU, runtimes, package managers, disk space |
+| `get_project_info` | Fetch GitHub project metadata without installing |
+| `check_system_health` | Full system diagnostic with fix suggestions |
+| `audit_dependencies` | Scan project dependencies for known CVEs |
+
+### Example: `install_github_project`
+
+The AI calls:
+```json
+{
+  "name": "install_github_project",
+  "arguments": {
+    "project": "comfyanonymous/ComfyUI"
+  }
+}
+```
+
+gitinstall handles everything:
+- Detects macOS Apple Silicon M3 + Python 3.12 + brew
+- Generates 3-step plan (clone → install PyTorch MPS → install deps)
+- Executes each step with safety checks
+- If `pip install` fails with PEP 668, auto-fixes with `python -m venv`
+- Returns success status + launch command
+
+### Example: `diagnose_install_error`
+
+The AI calls:
+```json
+{
+  "name": "diagnose_install_error",
+  "arguments": {
+    "stderr": "error: externally-managed-environment\n× This environment is externally managed",
+    "command": "pip install pandas"
+  }
+}
+```
+
+Returns:
+```json
+{
+  "root_cause": "System Python is protected (PEP 668), need virtual environment",
+  "fix_commands": ["python3 -m venv venv", "source venv/bin/activate"],
+  "confidence": "high"
+}
+```
+
+---
+
+## What makes it different
+
+### No LLM required
+
+The core engine is a **rule-based system**, not an AI wrapper:
+- 82 known projects have hand-crafted installation recipes
+- 30+ language templates (Python, Node, Rust, Go, C++, Haskell, Zig, Elixir...)
+- 28 error-fix rules covering real-world installation failures
+- LLM is optional — only used when the rule engine isn't confident
+
+### Zero dependencies
+
+```bash
+$ pip show gitinstall | grep Requires
+Requires:
+```
+
+Pure Python standard library. No `requests`, no `click`, no `rich`. One `pip install` and it works. No dependency conflicts, ever.
+
+### Safety built-in
+
+- **30+ dangerous command patterns blocked** (including base64/heredoc encoding bypass attempts)
+- **SSRF protection** on URL fetching (whitelist-only)
+- **No auto-sudo** — prompts explicitly when root needed
+- **Trusted failure detection** — stops retrying when the error is unfixable
+
+---
+
+## Also works as a CLI
+
+gitinstall works standalone too, no AI agent needed:
+
+```bash
+gitinstall comfyanonymous/ComfyUI     # Install a project
+gitinstall detect                      # Check your system
+gitinstall doctor                      # System diagnostic
+gitinstall audit pytorch/pytorch       # Security audit
+gitinstall plan neovim/neovim          # Preview install plan
+```
+
+---
+
+## Supported Languages & Platforms
+
+**Languages** (30+): Python, Node.js, TypeScript, Rust, Go, C, C++, Java, Kotlin, Scala, Swift, Ruby, PHP, Haskell, Zig, Elixir, Erlang, Clojure, Julia, Lua, Perl, R, Dart, .NET/C#, OCaml, Nim, V, Docker, Conda, CMake, Meson, Autotools, Bazel
+
+**Platforms**: macOS (Intel + Apple Silicon M1-M4), Ubuntu/Debian, Fedora/RHEL, Arch Linux, Windows 10/11, WSL2
+
+**GPU**: NVIDIA CUDA, AMD ROCm, Apple MPS, CPU fallback
+
+---
+
+## How It Works
+
+```
+User → AI Agent → MCP → gitinstall
+                         ├── detect   → OS / GPU / runtimes / package managers
+                         ├── fetch    → GitHub API → project type detection
+                         ├── plan     → SmartPlanner (known → template → README)
+                         ├── execute  → subprocess + safety filter + cd/venv tracking
+                         ├── fix      → 28 error patterns → auto-retry
+                         └── fallback → brew → cargo → source build
+```
+
+**SmartPlanner** has 3 tiers:
+1. **Known projects** (82): Hand-crafted recipes for popular projects (ComfyUI, Ollama, llama.cpp, Neovim...)
+2. **Language templates** (30+): Detect project type → apply template (handles Apple Silicon, CUDA, WSL2 edge cases)
+3. **README extraction**: Parse install commands from README (regex, or LLM if available)
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/icerui/github-installer.git
+cd github-installer
+
+# Run tests (2126 unit tests, zero external deps)
+python -m pytest tests/unit/ -q
+
+# Test MCP server
+python tests/test_mcp_server.py
+
+# Run locally
+python tools/mcp_server.py  # MCP server on stdio
+python tools/main.py detect # CLI mode
+```
+
+---
+
+## License
+
+MIT © icerui