Skip to content

Installation

Requirements

Requirement Version Purpose
Python 3.10+ Runtime
Claude Code CLI Latest AI execution engine

Platform Support

  • macOS & Linux: Fully supported
  • Windows: Use WSL2

Install ClaudeSprint

pip install claudesprint

Using pipx (Isolated Environment)

pipx install claudesprint

From Source

git clone https://github.com/arc-co/claudesprint.git
cd claudesprint
pip install -e ".[dev]"

Install Claude Code CLI

ClaudeSprint requires the Claude Code CLI to be installed and authenticated.

  1. Install following the official guide

  2. Authenticate: 

    claude login

  3. Verify: 

    claude --version

Verify Installation

Run the doctor command to check your environment:

claudesprint doctor

This checks:

  • Python version
  • Claude CLI installation
  • Claude CLI authentication
  • Optional dependencies

Use --fix to auto-install missing optional packages:

claudesprint doctor --fix

Optional Dependencies

Package Purpose Install
agent-browser Browser automation for E2E testing npm install -g agent-browser
nicegui Real-time dashboard Included by default

Browser Automation Setup

For projects with UI testing:

# Install agent-browser
npm install -g agent-browser

# Install browser dependencies
agent-browser install           # macOS
agent-browser install --with-deps  # Linux

Next Steps