/setup-start.en

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Codex Desktop or Cursor installed"]
level: "beginner"
tags: ["setup", "environment"]
nonInteractiveMode: incompatible

Training Environment Setup

Step 0: Check Setup Progress

**What the AI auto-runs:** 1. Run `uv run python tools/setup_progress.py show --current setup-start` to display current progress 2. Auto-check the following; if all succeed, ask "Basic tools are already installed. Would you like to skip?":

• `python3 --version`
• `node --version`
• `git --version`
• `gh --version`

3. On Mac, check if Homebrew is available with `which brew`. If available, offer the option to auto-install missing tools with `brew install`

What You'll Do in This Session

**Welcome to Training Environment Setup!**

| Item | Details | |------|---------| | Goal | Verify that Python / Node.js / Git / GitHub CLI are installed, and guide installation if anything is missing | | Duration | ~10 minutes (3 minutes if everything is already installed) | | Skills used | None (AI checks everything automatically) | | Prerequisites | Codex Desktop or Cursor installed, ai-agent-camp folder open | | Next command | `/setup-github` (GitHub account setup) |

**Session flow:** 1. Auto-detect OS (Mac / Windows) 2. Check Python 3. Check Node.js 4. Check Git 5. Check GitHub CLI

> **Important**: You do not need to type any commands in the terminal. The AI runs everything automatically behind the scenes. Just review the results displayed on screen. > > **Note for Codex**: In Codex, instead of calling `/setup-start` as a slash command, follow the check items in this document in order. The AI will hand off to you only for steps that require downloads or browser authentication. > > **Hint**: If the AI stops responding midway, type "please continue" or "it stopped" to resume. This is a Cursor behavior, not a malfunction.

---

Pre-session Confirmation

**AskQuestion configuration:**

{
  "title": "Pre-session confirmation",
  "questions": [{
    "id": "readiness",
    "prompt": "Are you ready?",
    "options": [
      {"id": "ready", "label": "Ready! Let's start"},
      {"id": "what_is_this", "label": "What does this command do?"},
      {"id": "different_lesson", "label": "Go to a different lesson"}
    ]
  }]
}

(ready -> Proceed to Step 1) (what_is_this -> Guide: "This command has the AI automatically check whether the software needed for the training is installed on your computer. If something is missing, you just follow the on-screen instructions to install it. No command input needed." -> Proceed to Step 1) (different_lesson -> Show module list)

---

Step 1: Auto-detect OS

**What the AI auto-runs:** The AI runs the following behind the scenes to detect the OS:

uname -s

Mac returns `Darwin`, Linux/WSL returns `Linux`. If `Linux` is returned, further check whether it is WSL:

grep -qi microsoft /proc/version 2>/dev/null && echo "WSL" || echo "Native Linux"

**Display the detection result:**

• Mac: "Your computer is a **Mac**. We'll proceed with Mac-specific steps."
• WSL: "Your computer is running **Windows (WSL)**. We'll proceed with Linux-based steps."
• Linux: "Your computer is running **Linux**. We'll proceed with Linux-specific steps."

**The detected OS information is used in all subsequent steps.**

> User action required: None (AI auto-detects everything)

---

Step 2: Check Python

**What the AI auto-runs:**

1. Run the following to check the version:

# Mac / Linux
python3 --version

# Windows
python --version

2. Evaluate the result:

• If a version is displayed -> Installed
• If command not found -> Not installed

If Python is installed

Display example:

Python 3.12.x found. No issues.

-> Automatically proceed to Step 3

If Python is not installed

**AskQuestion configuration:**

{
  "title": "Python installation required",
  "questions": [{
    "id": "python_install",
    "prompt": "Python 3 is not installed. We'll guide you through installation.",
    "options": [
      {"id": "guide_me", "label": "Show me the installation steps"},
      {"id": "already_done", "label": "I installed it another way (re-check)"}
    ]
  }]
}

(guide_me -> Show OS-specific instructions) (already_done -> Re-run `python3 --version` / `python --version` to check)

**Mac instructions:**

Follow these steps to install:

1. The AI will automatically open your browser (please wait a moment)
2. Click the yellow "Download Python 3.12.x" button on the page
3. Double-click the downloaded .pkg file
4. Follow the installer: click "Continue" -> "Install"
5. When done, type "finished" here

AI runs: open https://www.python.org/downloads/

**Windows instructions:**

Follow these steps to install:

1. The AI will automatically open your browser (please wait a moment)
   * If the browser doesn't open, open the Microsoft Store app and search for "Python 3.12"
2. Click the "Get" button for "Python 3.12" in the Microsoft Store
3. When installation is complete, type "finished" here

AI runs: start https://apps.microsoft.com/search?query=Python+3.12
# Falls back to start https://www.python.org/downloads/ on failure

**After installation:** AI re-runs `python3 --version` / `python --version` to verify.

• Success -> Display "Python installation complete!" and proceed to Step 3
• Failure -> Guide to the troubleshooting section

---

Step 3: Check Node.js

**What the AI auto-runs:**

1. Run the following to check the version:

node --version

2. Evaluate the result:

• Version 18.x or higher displayed -> Installed
• Version is old -> Guide upgrade
• Command not found -> Not installed

If Node.js is installed (18.x or higher)

Display example:

Node.js v20.x.x found. No issues.

-> Automatically proceed to Step 4

If Node.js is not installed / version is old

**AskQuestion configuration