Installation All Tiers

Detailed installation instructions for all platforms.

Requirements

  • Python 3.10+ (3.11 or 3.12 recommended)
  • pip or pipx
  • Claude Code (Pro or Max subscription)
  • Git (for version control features)

Install via pip

The recommended way to install PairCoder:

bash 
pip install bpsai-pair

Install via pipx (Isolated)

For isolated installation that won't conflict with other packages:

bash 
# Install pipx if you don't have it
pip install pipx
pipx ensurepath

# Install PairCoder
pipx install bpsai-pair

Verify Installation

bash 
bpsai-pair --version
# Should output: bpsai-pair 2.20.0

Upgrade to Latest Version

bash 
# Via pip
pip install --upgrade bpsai-pair

# Via pipx
pipx upgrade bpsai-pair

Install License

After purchasing, download your license file and install it:

bash 
# Install license from file
bpsai-pair license install ~/Downloads/license.json

# Or use the interactive wizard
bpsai-pair wizard

Check your license status:

bash 
bpsai-pair license status
Tip

The license is stored in ~/.paircoder/license.json and applies globally to all projects on your machine.

Platform-Specific Notes

macOS

If using Homebrew Python:

bash 
brew install python@3.12
pip3 install bpsai-pair

Linux

Ensure Python 3.10+ is installed:

bash 
# Ubuntu/Debian
sudo apt update
sudo apt install python3.12 python3-pip

# Install PairCoder
pip3 install bpsai-pair

Windows

Use Python from python.org or the Windows Store:

bash 
# In PowerShell or Command Prompt
pip install bpsai-pair

Troubleshooting

Command not found

If bpsai-pair isn't found after installation:

bash 
# Try running as a module
python -m bpsai_pair.cli --help

# Or check if it's in your PATH
which bpsai-pair  # macOS/Linux
where bpsai-pair  # Windows

Permission errors

Don't use sudo pip install. Instead, use:

bash 
# Install for current user only
pip install --user bpsai-pair

# Or use pipx (recommended)
pipx install bpsai-pair

Python version errors

Check your Python version:

bash 
python --version
# Must be 3.10 or higher

Next Steps