🔧 AI Tool Installer _{· AI 工具安装助手}

One-Click Installer for AI Coding Tools

Automatic environment detection · Dependency management · One-click installation
Supports Claude Code, Codex CLI, Cursor, DeepSeek TUI, Windsurf, Trae, and more

How it works — 4 simple steps

① Welcome Launch the installer	② Select Tools Choose AI coding tools
③ Detect Environment Auto-check Node, Git & network	④ Install One-click install, ready to use

✅ Result: Tools Installed & Running DeepSeek TUI successfully installed and running in terminal

---

📖 Overview

AI Tool Installer is a desktop GUI application that helps developers set up AI coding tools in minutes. Instead of visiting multiple websites, running scattered install commands, and manually configuring PATH — just select the tools you want and click install.

Why this exists

Setting up AI coding tools like Claude Code, Cursor, or DeepSeek TUI typically requires:

1. Installing Node.js (checking versions, configuring PATH)
2. Installing Git
3. Running npm install -g commands
4. Manually linking binaries to PATH
5. Repeating for each tool

This installer automates the entire process — from environment detection to installation — especially optimized for users in China (mainland) where downloading from international sources can be slow.

---

✨ Features

Feature	Description
🖥️ Desktop GUI	No terminal commands needed — simple point-and-click interface
🔍 Auto Detection	Detects Node.js, Git, Python versions and network connectivity
⚡ Smart Mirror	Auto-switches to Chinese mirrors (npmmirror.com) when international sources are slow
📦 One-Click Install	Select multiple tools → detect → install, all in one flow
🔗 PATH Auto-Link	CLI binaries automatically linked to ~/.local/bin — use immediately after install
🌐 Cross-Platform	macOS (Apple Silicon + Intel) and Windows support

---

📦 Supported Products (14 tools)

CLI / Terminal AI Agents

Tools that run in your terminal — perfect for automation and direct code manipulation.

Product	Vendor	Install	Stars
Claude Code	Anthropic	npm i -g @anthropic-ai/claude-code	—
Codex CLI	OpenAI	npm i -g @openai/codex	—
OpenCode	SST / anomalyco	npm i -g opencode-ai	⭐ 163k
DeepSeek TUI	Hunter Bown	npm i -g deepseek-tui	⭐ 33k
Kimi Code	Moonshot AI	npm i -g kimi-code	—
Qoder CLI	Alibaba Cloud	npm i -g @qoder-ai/qodercli	—
OpenClaw	Open Source	npm i -g openclaw	—
Hermes Agent	Nous Research	Install script	—

AI Code Editors

Desktop applications with built-in AI capabilities.

Product	Vendor	Platform
Cursor	Anysphere	macOS, Windows
Windsurf	Codeium	macOS, Windows, Linux
Trae	ByteDance	macOS, Windows
Qoder Desktop	Alibaba Cloud	macOS, Windows, Linux
VS Code	Microsoft	macOS, Windows, Linux

Management Tools

Product	Vendor	Description
CC Switch	Open Source	Switch between and manage multiple AI coding assistants

---

🚀 Quick Start

🖥️ macOS 用户

项目根目录 AI-Installer.app 双击即可运行。

🪟 Windows 用户

方法一（推荐）： 去 Releases 页面 下载最新版 .exe 安装包，双击安装。

方法二： 双击项目里的 start.bat，会自动安装依赖并启动。

方法三： 打开终端运行：

git clone https://github.com/questionjie-max/ai-installer.git
cd ai-installer
npm install
npm start

Usage Flow

1. Open app    →   2. Select tools    →   3. Detect environment    →   4. Click install    →   ✅ Done!
     ↓                    ↓                       ↓                           ↓
  Welcome screen      Check 14 tools         Auto-checks Node,         Automated npm install,
                     across 3 categories     Git & network status      PATH linking, downloads

---

🧩 Architecture

ai-installer/
├── main.js              # Electron main process — window management & IPC
├── preload.js           # Secure bridge between renderer and main process
├── products.json        # Configuration for all 14 supported products
├── modules/
│   ├── products.js      # Product config loader & dependency resolver
│   ├── detector.js      # Environment detection — Node, Git, network
│   └── installer.js     # Installation engine — npm, download, script
├── renderer/
│   ├── index.html       # 4-page UI (welcome, select, detect, install)
│   ├── css/style.css    # Dark theme, glassmorphism design
│   └── js/app.js        # Frontend interaction logic
├── docs/                # Documentation & screenshots
└── package.json         # Electron + electron-builder

Built with Electron — cross-platform desktop applications with web technologies.

---

🖥️ Building from Source

# Install dependencies
npm install

# Run in development mode
npm start

# Build for macOS
npm run build:mac

# Build for Windows (requires Wine on macOS)
npm run build:win

Output is in the dist/ directory.

---

🌏 Network Optimization

For users in mainland China:

The installer automatically detects network conditions:

• Fast international access → uses official package sources (npmjs.org)
• Slow or blocked → auto-switches to npmmirror.com (Alibaba Cloud mirror)

No manual configuration or VPN required.

Offline Cache

Pre-downloaded installers can be placed in the cache/ directory for air-gapped environments.

---

📄 License

This project is MIT licensed.

---

🤝 Contributing

Contributions are welcome! Whether it's adding support for new AI tools, improving the UI, or fixing bugs:

1. Open an issue to discuss changes
2. Submit a pull request
3. Star the repo ⭐ to help others discover it

---

_{Made for developers who just want to code with AI, not configure it.
Built with ❤️ for the open source community}