Chapter 04 | Environment Setup Checklist

Chapter 4: Environment Setup Checklist

Learning Objectives

Confirm your machine has all the prerequisites installed to run the doc2video project.

One-Time Check Script

Paste the following into your terminal; the output will list the status of each tool:

echo "=== Required ==="
node --version 2>/dev/null && echo "✓ Node" || echo "✗ Node (20.19+ required)"
python3 --version 2>/dev/null && echo "✓ Python" || echo "✗ Python (3.11+ required)"
git --version 2>/dev/null && echo "✓ git" || echo "✗ git"
which tmux >/dev/null && echo "✓ tmux" || echo "✗ tmux"
which ffmpeg >/dev/null && echo "✓ ffmpeg" || echo "✗ ffmpeg"
ls /Applications/Google\ Chrome.app >/dev/null 2>&1 && echo "✓ Chrome" || echo "✗ Chrome"

echo ""
echo "=== macOS Version ==="
sw_vers -productVersion

Expected Output:

✓ Node
✓ Python
✓ git
✓ tmux
✓ ffmpeg
✓ Chrome

15.0.0  (macOS 12+ is sufficient)

What to Install if Missing

flowchart TB
    Start["Run Check Script"] --> Q1{Node?}
    Q1 -->|Missing| InstallNode["brew install node
or nvm install 22"]
    Q1 -->|Present| Q2{Python?}
    InstallNode --> Q2
    Q2 -->|Missing| InstallPy["brew install python@3.11"]
    Q2 -->|Present| Q3{tmux + ffmpeg?}
    InstallPy --> Q3
    Q3 -->|Missing| InstallSys["brew install tmux ffmpeg"]
    Q3 -->|Present| Q4{Chrome?}
    InstallSys --> Q4
    Q4 -->|Missing| InstallChrome["Install from google.com/chrome"]
    Q4 -->|Present| Done["✓ Environment Ready"]
    InstallChrome --> Done

    style Done fill:#c8e6c9

Common Pitfalls

Things NOT to Do

✗ Use sudo pip install ...        Global pollution
✗ Use conda                       Conflicts with venv
✗ Share brew across users         Permission issues

What You Can Do Now

• Verify your machine meets all prerequisites
• Know how to install any missing tools

The next chapter covers installing Claude Code itself.