From 31ed267027a3b3df16d22c559b9df1cc1acb22ef Mon Sep 17 00:00:00 2001
From: Stefano Fiorini <stefano@Stefanos-MacBook-Air.local>
Date: Sun, 15 Mar 2026 04:01:07 -0500
Subject: [PATCH] docs: use python3 pip bootstrap for us-cpa install

---
 docs/us-cpa.md                  | 10 ++++++----
 skills/us-cpa/README.md         | 10 ++++++----
 skills/us-cpa/tests/test_cli.py |  9 ++++++---
 3 files changed, 18 insertions(+), 11 deletions(-)

diff --git a/docs/us-cpa.md b/docs/us-cpa.md
index b9865ee..956ee48 100644
--- a/docs/us-cpa.md
+++ b/docs/us-cpa.md
@@ -7,8 +7,9 @@
 From `skills/us-cpa/`:
 
 ```bash
-python -m pip install --upgrade pip setuptools wheel
-pip install -e '.[dev]'
+python3 -m ensurepip --upgrade
+python3 -m pip install --upgrade pip setuptools wheel
+python3 -m pip install -e '.[dev]'
 us-cpa --help
 ```
 
@@ -36,8 +37,9 @@ rsync -a --delete \
 cd ~/.openclaw/workspace/skills/us-cpa
 python3 -m venv .venv
 . .venv/bin/activate
-python -m pip install --upgrade pip setuptools wheel
-pip install -e '.[dev]'
+python3 -m ensurepip --upgrade
+python3 -m pip install --upgrade pip setuptools wheel
+python3 -m pip install -e '.[dev]'
 ```
 
 3. Verify the installed workspace wrapper:
diff --git a/skills/us-cpa/README.md b/skills/us-cpa/README.md
index 45d53af..b762c63 100644
--- a/skills/us-cpa/README.md
+++ b/skills/us-cpa/README.md
@@ -7,8 +7,9 @@ Standalone Python CLI package for the `us-cpa` skill.
 From `skills/us-cpa/`:
 
 ```bash
-python -m pip install --upgrade pip setuptools wheel
-pip install -e '.[dev]'
+python3 -m ensurepip --upgrade
+python3 -m pip install --upgrade pip setuptools wheel
+python3 -m pip install -e '.[dev]'
 ```
 
 ## OpenClaw installation
@@ -29,8 +30,9 @@ rsync -a --delete \
 cd ~/.openclaw/workspace/skills/us-cpa
 python3 -m venv .venv
 . .venv/bin/activate
-python -m pip install --upgrade pip setuptools wheel
-pip install -e '.[dev]'
+python3 -m ensurepip --upgrade
+python3 -m pip install --upgrade pip setuptools wheel
+python3 -m pip install -e '.[dev]'
 ```
 
 3. Run the workspace wrapper:
diff --git a/skills/us-cpa/tests/test_cli.py b/skills/us-cpa/tests/test_cli.py
index a6e6efa..39a5547 100644
--- a/skills/us-cpa/tests/test_cli.py
+++ b/skills/us-cpa/tests/test_cli.py
@@ -37,7 +37,8 @@ class UsCpaCliSmokeTests(unittest.TestCase):
     def test_readme_documents_install_and_script_usage(self) -> None:
         readme = (SKILL_DIR / "README.md").read_text()
         self.assertIn("pip install -e '.[dev]'", readme)
-        self.assertIn("python -m pip install --upgrade pip setuptools wheel", readme)
+        self.assertIn("python3 -m ensurepip --upgrade", readme)
+        self.assertIn("python3 -m pip install --upgrade pip setuptools wheel", readme)
         self.assertIn("scripts/us-cpa", readme)
         self.assertIn("python -m unittest", readme)
 
@@ -49,11 +50,13 @@ class UsCpaCliSmokeTests(unittest.TestCase):
         self.assertIn("OpenClaw installation", readme)
         self.assertIn("~/.openclaw/workspace/skills/us-cpa", readme)
         self.assertIn(".venv/bin/python", readme)
-        self.assertIn("python -m pip install --upgrade pip setuptools wheel", readme)
+        self.assertIn("python3 -m ensurepip --upgrade", readme)
+        self.assertIn("python3 -m pip install --upgrade pip setuptools wheel", readme)
         self.assertNotIn("/Users/stefano/", readme)
         self.assertIn("OpenClaw installation", operator_doc)
         self.assertIn("rsync -a --delete", operator_doc)
-        self.assertIn("python -m pip install --upgrade pip setuptools wheel", operator_doc)
+        self.assertIn("python3 -m ensurepip --upgrade", operator_doc)
+        self.assertIn("python3 -m pip install --upgrade pip setuptools wheel", operator_doc)
         self.assertIn("~/", operator_doc)
         self.assertNotIn("/Users/stefano/", operator_doc)
         self.assertIn("~/.openclaw/workspace/skills/us-cpa/scripts/us-cpa", skill_doc)