From 46b361b7329323dc2e82d6288e643344d0bb46a1 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 20:46:01 +0000
Subject: [PATCH 01/15] Add bump2version configuration for all Python packages
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds .bumpversion.cfg files to each Python package (agent, computer,
computer-server, core, mcp-server, pylume, som) to enable automated
version bumping with bump2version tool.

Includes comprehensive Makefile with targets for:
- Installing and managing bump2version
- Bumping package versions (major, minor, patch)
- Managing dependencies and building packages
- Running tests and formatting
- Cleaning build artifacts

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 Makefile                                     | 166 +++++++++++++++++++
 libs/python/agent/.bumpversion.cfg           |   9 +
 libs/python/computer-server/.bumpversion.cfg |   9 +
 libs/python/computer/.bumpversion.cfg        |   9 +
 libs/python/core/.bumpversion.cfg            |   9 +
 libs/python/mcp-server/.bumpversion.cfg      |   9 +
 libs/python/pylume/.bumpversion.cfg          |   9 +
 libs/python/som/.bumpversion.cfg             |   9 +
 8 files changed, 229 insertions(+)
 create mode 100644 Makefile
 create mode 100644 libs/python/agent/.bumpversion.cfg
 create mode 100644 libs/python/computer-server/.bumpversion.cfg
 create mode 100644 libs/python/computer/.bumpversion.cfg
 create mode 100644 libs/python/core/.bumpversion.cfg
 create mode 100644 libs/python/mcp-server/.bumpversion.cfg
 create mode 100644 libs/python/pylume/.bumpversion.cfg
 create mode 100644 libs/python/som/.bumpversion.cfg

diff --git a/Makefile b/Makefile
new file mode 100644
index 00000000..8d0f718b
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,166 @@
+# Python Package Release Makefile
+# This Makefile provides convenient targets for bumping versions of all Python packages
+# using bump2version. After running a target, remember to push: git push origin main
+
+.PHONY: help
+
+help: ## Show this help message
+	@echo "Python Package Release Automation"
+	@echo ""
+	@echo "Usage: make <target>"
+	@echo ""
+	@echo "Available targets:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  %-25s %s\n", $$1, $$2}'
+	@echo ""
+	@echo "After bumping, push changes with: git push origin main"
+
+# Core package targets
+bump-patch-core: ## Bump patch version of cua-core (0.1.8 → 0.1.9)
+	@echo "Bumping cua-core patch version..."
+	cd libs/python/core && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-core: ## Bump minor version of cua-core (0.1.8 → 0.2.0)
+	@echo "Bumping cua-core minor version..."
+	cd libs/python/core && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-core: ## Bump major version of cua-core (0.1.8 → 1.0.0)
+	@echo "Bumping cua-core major version..."
+	cd libs/python/core && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# Pylume package targets
+bump-patch-pylume: ## Bump patch version of pylume (0.2.2 → 0.2.3)
+	@echo "Bumping pylume patch version..."
+	cd libs/python/pylume && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-pylume: ## Bump minor version of pylume (0.2.2 → 0.3.0)
+	@echo "Bumping pylume minor version..."
+	cd libs/python/pylume && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-pylume: ## Bump major version of pylume (0.2.2 → 1.0.0)
+	@echo "Bumping pylume major version..."
+	cd libs/python/pylume && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# Computer package targets
+bump-patch-computer: ## Bump patch version of cua-computer (0.4.0 → 0.4.1)
+	@echo "Bumping cua-computer patch version..."
+	cd libs/python/computer && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-computer: ## Bump minor version of cua-computer (0.4.0 → 0.5.0)
+	@echo "Bumping cua-computer minor version..."
+	cd libs/python/computer && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-computer: ## Bump major version of cua-computer (0.4.0 → 1.0.0)
+	@echo "Bumping cua-computer major version..."
+	cd libs/python/computer && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# SOM package targets
+bump-patch-som: ## Bump patch version of cua-som (0.1.0 → 0.1.1)
+	@echo "Bumping cua-som patch version..."
+	cd libs/python/som && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-som: ## Bump minor version of cua-som (0.1.0 → 0.2.0)
+	@echo "Bumping cua-som minor version..."
+	cd libs/python/som && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-som: ## Bump major version of cua-som (0.1.0 → 1.0.0)
+	@echo "Bumping cua-som major version..."
+	cd libs/python/som && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# Agent package targets
+bump-patch-agent: ## Bump patch version of cua-agent (0.4.0 → 0.4.1)
+	@echo "Bumping cua-agent patch version..."
+	cd libs/python/agent && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-agent: ## Bump minor version of cua-agent (0.4.0 → 0.5.0)
+	@echo "Bumping cua-agent minor version..."
+	cd libs/python/agent && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-agent: ## Bump major version of cua-agent (0.4.0 → 1.0.0)
+	@echo "Bumping cua-agent major version..."
+	cd libs/python/agent && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# Computer Server package targets
+bump-patch-computer-server: ## Bump patch version of cua-computer-server (0.1.0 → 0.1.1)
+	@echo "Bumping cua-computer-server patch version..."
+	cd libs/python/computer-server && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-computer-server: ## Bump minor version of cua-computer-server (0.1.0 → 0.2.0)
+	@echo "Bumping cua-computer-server minor version..."
+	cd libs/python/computer-server && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-computer-server: ## Bump major version of cua-computer-server (0.1.0 → 1.0.0)
+	@echo "Bumping cua-computer-server major version..."
+	cd libs/python/computer-server && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# MCP Server package targets
+bump-patch-mcp-server: ## Bump patch version of cua-mcp-server (0.1.0 → 0.1.1)
+	@echo "Bumping cua-mcp-server patch version..."
+	cd libs/python/mcp-server && bump2version patch
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-minor-mcp-server: ## Bump minor version of cua-mcp-server (0.1.0 → 0.2.0)
+	@echo "Bumping cua-mcp-server minor version..."
+	cd libs/python/mcp-server && bump2version minor
+	@echo "✓ Done! Now run: git push origin main"
+
+bump-major-mcp-server: ## Bump major version of cua-mcp-server (0.1.0 → 1.0.0)
+	@echo "Bumping cua-mcp-server major version..."
+	cd libs/python/mcp-server && bump2version major
+	@echo "✓ Done! Now run: git push origin main"
+
+# Convenience targets for common workflows
+bump-all-patch: ## Bump patch version for ALL packages (use with caution!)
+	@echo "⚠️  Bumping patch version for ALL packages..."
+	@read -p "Are you sure? [y/N] " -n 1 -r; \
+	echo; \
+	if [[ $$REPLY =~ ^[Yy]$$ ]]; then \
+		$(MAKE) bump-patch-core && \
+		$(MAKE) bump-patch-pylume && \
+		$(MAKE) bump-patch-computer && \
+		$(MAKE) bump-patch-som && \
+		$(MAKE) bump-patch-agent && \
+		$(MAKE) bump-patch-computer-server && \
+		$(MAKE) bump-patch-mcp-server; \
+	fi
+
+# Dry run targets (test without making changes)
+dry-run-patch-%: ## Dry run for patch version bump (e.g., make dry-run-patch-core)
+	@echo "Dry run: Bumping $* patch version..."
+	cd libs/python/$* && bump2version --dry-run --verbose patch
+
+dry-run-minor-%: ## Dry run for minor version bump (e.g., make dry-run-minor-core)
+	@echo "Dry run: Bumping $* minor version..."
+	cd libs/python/$* && bump2version --dry-run --verbose minor
+
+dry-run-major-%: ## Dry run for major version bump (e.g., make dry-run-major-core)
+	@echo "Dry run: Bumping $* major version..."
+	cd libs/python/$* && bump2version --dry-run --verbose major
+
+# Show current versions
+show-versions: ## Show current versions of all packages
+	@echo "Current Python package versions:"
+	@echo "  cua-core:           $$(grep 'current_version' libs/python/core/.bumpversion.cfg | cut -d' ' -f3)"
+	@echo "  pylume:             $$(grep 'current_version' libs/python/pylume/.bumpversion.cfg | cut -d' ' -f3)"
+	@echo "  cua-computer:       $$(grep 'current_version' libs/python/computer/.bumpversion.cfg | cut -d' ' -f3)"
+	@echo "  cua-som:            $$(grep 'current_version' libs/python/som/.bumpversion.cfg | cut -d' ' -f3)"
+	@echo "  cua-agent:          $$(grep 'current_version' libs/python/agent/.bumpversion.cfg | cut -d' ' -f3)"
+	@echo "  cua-computer-server: $$(grep 'current_version' libs/python/computer-server/.bumpversion.cfg | cut -d' ' -f3)"
+	@echo "  cua-mcp-server:     $$(grep 'current_version' libs/python/mcp-server/.bumpversion.cfg | cut -d' ' -f3)"
diff --git a/libs/python/agent/.bumpversion.cfg b/libs/python/agent/.bumpversion.cfg
new file mode 100644
index 00000000..f01394d6
--- /dev/null
+++ b/libs/python/agent/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.4.0
+commit = True
+tag = False
+message = Bump cua-agent to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
new file mode 100644
index 00000000..f1eb85d4
--- /dev/null
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.1.0
+commit = True
+tag = False
+message = Bump cua-computer-server to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
diff --git a/libs/python/computer/.bumpversion.cfg b/libs/python/computer/.bumpversion.cfg
new file mode 100644
index 00000000..aa6e314c
--- /dev/null
+++ b/libs/python/computer/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.4.0
+commit = True
+tag = False
+message = Bump cua-computer to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
diff --git a/libs/python/core/.bumpversion.cfg b/libs/python/core/.bumpversion.cfg
new file mode 100644
index 00000000..9becf7a6
--- /dev/null
+++ b/libs/python/core/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.1.8
+commit = True
+tag = False
+message = Bump cua-core to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
diff --git a/libs/python/mcp-server/.bumpversion.cfg b/libs/python/mcp-server/.bumpversion.cfg
new file mode 100644
index 00000000..4fa92d6f
--- /dev/null
+++ b/libs/python/mcp-server/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.1.0
+commit = True
+tag = False
+message = Bump cua-mcp-server to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
diff --git a/libs/python/pylume/.bumpversion.cfg b/libs/python/pylume/.bumpversion.cfg
new file mode 100644
index 00000000..d57f68ff
--- /dev/null
+++ b/libs/python/pylume/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.2.2
+commit = True
+tag = False
+message = Bump pylume to v{new_version}
+
+[bumpversion:file:pylume/__init__.py]
+search = __version__ = "{current_version}"
+replace = __version__ = "{new_version}"
diff --git a/libs/python/som/.bumpversion.cfg b/libs/python/som/.bumpversion.cfg
new file mode 100644
index 00000000..15e60ac4
--- /dev/null
+++ b/libs/python/som/.bumpversion.cfg
@@ -0,0 +1,9 @@
+[bumpversion]
+current_version = 0.1.0
+commit = True
+tag = False
+message = Bump cua-som to v{new_version}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"

From 788ce5cdd44c37d18809e42eb3c89ba7594127d3 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:27:40 +0000
Subject: [PATCH 02/15] update readme

---
 README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/README.md b/README.md
index df8ab727..9aed1994 100644
--- a/README.md
+++ b/README.md
@@ -206,6 +206,63 @@ Some optional extras for this project depend on third-party packages that are li
 
 When you choose to install and use such optional extras, your use, modification, and distribution of those third-party components are governed by their respective licenses (e.g., AGPL-3.0 for `ultralytics`).
 
+## Releasing Packages
+
+Cua uses `bump2version` to manage package versions across all Python modules. A Makefile is provided to simplify the release process.
+
+### View Current Versions
+
+```bash
+make show-versions
+```
+
+### Bump Package Versions
+
+To bump a specific package version:
+
+```bash
+# Patch version bump (e.g., 0.1.8 → 0.1.9)
+make bump-patch-core          # cua-core
+make bump-patch-pylume        # pylume
+make bump-patch-computer      # cua-computer
+make bump-patch-som           # cua-som
+make bump-patch-agent         # cua-agent
+make bump-patch-computer-server  # cua-computer-server
+make bump-patch-mcp-server    # cua-mcp-server
+
+# Minor version bump (e.g., 0.1.8 → 0.2.0)
+make bump-minor-core          # Replace 'core' with any package name
+
+# Major version bump (e.g., 0.1.8 → 1.0.0)
+make bump-major-core          # Replace 'core' with any package name
+```
+
+### Dry Run (Test Before Bumping)
+
+To preview changes without modifying files:
+
+```bash
+make dry-run-patch-core       # Test patch bump for cua-core
+make dry-run-minor-pylume     # Test minor bump for pylume
+make dry-run-major-agent      # Test major bump for cua-agent
+```
+
+### Bump All Packages (Use with Caution)
+
+```bash
+make bump-all-patch           # Bumps patch version for ALL packages
+```
+
+### After Bumping
+
+After running any bump command, push your changes:
+
+```bash
+git push origin main
+```
+
+For more details, run `make help` or see the [Makefile](./Makefile).
+
 ## Contributing
 
 We welcome contributions to Cua! Please refer to our [Contributing Guidelines](CONTRIBUTING.md) for details.

From cb29dd83b6c39fee387d76d689dd050f50a119ef Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:31:19 +0000
Subject: [PATCH 03/15] Bump cua-computer-server to v0.1.1

---
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index f1eb85d4..eda87326 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.0
+current_version = 0.1.1
 commit = True
 tag = False
 message = Bump cua-computer-server to v{new_version}
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index 6e9e7240..d8009cbd 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer-server"
-version = "0.1.0"
+version = "0.1.1"
 description = "Server component for the Computer-Use Interface (CUI) framework powering Cua"
 authors = [
     { name = "TryCua", email = "gh@trycua.com" }

From 2ff40307092007f2c2c30ff40ee1e8e8ec4d1e9f Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:33:45 +0000
Subject: [PATCH 04/15] tag

---
 libs/python/agent/.bumpversion.cfg           | 2 +-
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer/.bumpversion.cfg        | 2 +-
 libs/python/core/.bumpversion.cfg            | 2 +-
 libs/python/mcp-server/.bumpversion.cfg      | 2 +-
 libs/python/pylume/.bumpversion.cfg          | 2 +-
 libs/python/som/.bumpversion.cfg             | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/libs/python/agent/.bumpversion.cfg b/libs/python/agent/.bumpversion.cfg
index f01394d6..d3d69abf 100644
--- a/libs/python/agent/.bumpversion.cfg
+++ b/libs/python/agent/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.4.0
 commit = True
-tag = False
+tag = True
 message = Bump cua-agent to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index eda87326..5ed5d152 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.1.1
 commit = True
-tag = False
+tag = True
 message = Bump cua-computer-server to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/computer/.bumpversion.cfg b/libs/python/computer/.bumpversion.cfg
index aa6e314c..7762d66e 100644
--- a/libs/python/computer/.bumpversion.cfg
+++ b/libs/python/computer/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.4.0
 commit = True
-tag = False
+tag = True
 message = Bump cua-computer to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/core/.bumpversion.cfg b/libs/python/core/.bumpversion.cfg
index 9becf7a6..6b37b331 100644
--- a/libs/python/core/.bumpversion.cfg
+++ b/libs/python/core/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.1.8
 commit = True
-tag = False
+tag = True
 message = Bump cua-core to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/mcp-server/.bumpversion.cfg b/libs/python/mcp-server/.bumpversion.cfg
index 4fa92d6f..a188d27c 100644
--- a/libs/python/mcp-server/.bumpversion.cfg
+++ b/libs/python/mcp-server/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.1.0
 commit = True
-tag = False
+tag = True
 message = Bump cua-mcp-server to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/pylume/.bumpversion.cfg b/libs/python/pylume/.bumpversion.cfg
index d57f68ff..2c782cad 100644
--- a/libs/python/pylume/.bumpversion.cfg
+++ b/libs/python/pylume/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.2.2
 commit = True
-tag = False
+tag = True
 message = Bump pylume to v{new_version}
 
 [bumpversion:file:pylume/__init__.py]
diff --git a/libs/python/som/.bumpversion.cfg b/libs/python/som/.bumpversion.cfg
index 15e60ac4..4492360f 100644
--- a/libs/python/som/.bumpversion.cfg
+++ b/libs/python/som/.bumpversion.cfg
@@ -1,7 +1,7 @@
 [bumpversion]
 current_version = 0.1.0
 commit = True
-tag = False
+tag = True
 message = Bump cua-som to v{new_version}
 
 [bumpversion:file:pyproject.toml]

From 7cb6857ff8cfed8ed4bef157af12c6e5874c015d Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:33:47 +0000
Subject: [PATCH 05/15] Bump cua-computer-server to v0.1.2

---
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index 5ed5d152..c957d42a 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.1
+current_version = 0.1.2
 commit = True
 tag = True
 message = Bump cua-computer-server to v{new_version}
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index d8009cbd..f8ddb127 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer-server"
-version = "0.1.1"
+version = "0.1.2"
 description = "Server component for the Computer-Use Interface (CUI) framework powering Cua"
 authors = [
     { name = "TryCua", email = "gh@trycua.com" }

From 1bc6fa01d38eb8241cde294788f8c26c3eb72d0d Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:34:48 +0000
Subject: [PATCH 06/15] make version match git

---
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index c957d42a..45736bfb 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.2
+current_version = 0.1.24
 commit = True
 tag = True
 message = Bump cua-computer-server to v{new_version}
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index f8ddb127..941f43c5 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer-server"
-version = "0.1.2"
+version = "0.1.24"
 description = "Server component for the Computer-Use Interface (CUI) framework powering Cua"
 authors = [
     { name = "TryCua", email = "gh@trycua.com" }

From eaf6d29ef6e6a9c2f0cd77228abb89e1e917471b Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:34:51 +0000
Subject: [PATCH 07/15] Bump cua-computer-server to v0.1.25

---
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index 45736bfb..db453b1e 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.24
+current_version = 0.1.25
 commit = True
 tag = True
 message = Bump cua-computer-server to v{new_version}
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index 941f43c5..d5dfd5b3 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer-server"
-version = "0.1.24"
+version = "0.1.25"
 description = "Server component for the Computer-Use Interface (CUI) framework powering Cua"
 authors = [
     { name = "TryCua", email = "gh@trycua.com" }

From 0af7ea394f338c5f6026a4e8e9747f4bfc6720de Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:51:18 +0000
Subject: [PATCH 08/15] add tag prefix

---
 libs/python/agent/.bumpversion.cfg           | 1 +
 libs/python/computer-server/.bumpversion.cfg | 1 +
 libs/python/computer/.bumpversion.cfg        | 1 +
 libs/python/core/.bumpversion.cfg            | 1 +
 libs/python/mcp-server/.bumpversion.cfg      | 1 +
 libs/python/pylume/.bumpversion.cfg          | 1 +
 libs/python/som/.bumpversion.cfg             | 1 +
 7 files changed, 7 insertions(+)

diff --git a/libs/python/agent/.bumpversion.cfg b/libs/python/agent/.bumpversion.cfg
index d3d69abf..05d99468 100644
--- a/libs/python/agent/.bumpversion.cfg
+++ b/libs/python/agent/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.4.0
 commit = True
 tag = True
+tag_name = agent-v{new_version}
 message = Bump cua-agent to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index db453b1e..1f1d9539 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.1.25
 commit = True
 tag = True
+tag_name = computer-server-v{new_version}
 message = Bump cua-computer-server to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/computer/.bumpversion.cfg b/libs/python/computer/.bumpversion.cfg
index 7762d66e..32b7e60e 100644
--- a/libs/python/computer/.bumpversion.cfg
+++ b/libs/python/computer/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.4.0
 commit = True
 tag = True
+tag_name = computer-v{new_version}
 message = Bump cua-computer to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/core/.bumpversion.cfg b/libs/python/core/.bumpversion.cfg
index 6b37b331..14c00eb4 100644
--- a/libs/python/core/.bumpversion.cfg
+++ b/libs/python/core/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.1.8
 commit = True
 tag = True
+tag_name = core-v{new_version}
 message = Bump cua-core to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/mcp-server/.bumpversion.cfg b/libs/python/mcp-server/.bumpversion.cfg
index a188d27c..5c354295 100644
--- a/libs/python/mcp-server/.bumpversion.cfg
+++ b/libs/python/mcp-server/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.1.0
 commit = True
 tag = True
+tag_name = mcp-server-v{new_version}
 message = Bump cua-mcp-server to v{new_version}
 
 [bumpversion:file:pyproject.toml]
diff --git a/libs/python/pylume/.bumpversion.cfg b/libs/python/pylume/.bumpversion.cfg
index 2c782cad..c57ee4cc 100644
--- a/libs/python/pylume/.bumpversion.cfg
+++ b/libs/python/pylume/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.2.2
 commit = True
 tag = True
+tag_name = pylume-v{new_version}
 message = Bump pylume to v{new_version}
 
 [bumpversion:file:pylume/__init__.py]
diff --git a/libs/python/som/.bumpversion.cfg b/libs/python/som/.bumpversion.cfg
index 4492360f..275c2177 100644
--- a/libs/python/som/.bumpversion.cfg
+++ b/libs/python/som/.bumpversion.cfg
@@ -2,6 +2,7 @@
 current_version = 0.1.0
 commit = True
 tag = True
+tag_name = som-v{new_version}
 message = Bump cua-som to v{new_version}
 
 [bumpversion:file:pyproject.toml]

From e3aaa30cedebcc39307c21b59959dbca48e0ad2d Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 21:51:22 +0000
Subject: [PATCH 09/15] Bump cua-computer-server to v0.1.26

---
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index 1f1d9539..369c7e05 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.25
+current_version = 0.1.26
 commit = True
 tag = True
 tag_name = computer-server-v{new_version}
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index d5dfd5b3..ee0ae659 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer-server"
-version = "0.1.25"
+version = "0.1.26"
 description = "Server component for the Computer-Use Interface (CUI) framework powering Cua"
 authors = [
     { name = "TryCua", email = "gh@trycua.com" }

From 119e2731cb2b7249afbf2c4c2012adf35ef52b1d Mon Sep 17 00:00:00 2001
From: r33drichards <rwendt1337@gmail.com>
Date: Fri, 10 Oct 2025 15:23:10 -0700
Subject: [PATCH 10/15] Add prerequisites for bump2version installation

Added prerequisites section for bump2version installation.
---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 9aed1994..0e6268f9 100644
--- a/README.md
+++ b/README.md
@@ -210,6 +210,16 @@ When you choose to install and use such optional extras, your use, modification,
 
 Cua uses `bump2version` to manage package versions across all Python modules. A Makefile is provided to simplify the release process.
 
+### Prerequisites 
+
+#### install `bump2version`
+
+using brew
+```
+brew install bumpversion
+```
+
+
 ### View Current Versions
 
 ```bash

From 424b8762c452728a768bc80dcaa071b8643ec8a3 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 22:36:07 +0000
Subject: [PATCH 11/15] bump versions

---
 libs/python/agent/.bumpversion.cfg      | 2 +-
 libs/python/computer/.bumpversion.cfg   | 2 +-
 libs/python/core/.bumpversion.cfg       | 2 +-
 libs/python/mcp-server/.bumpversion.cfg | 2 +-
 libs/python/som/.bumpversion.cfg        | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/libs/python/agent/.bumpversion.cfg b/libs/python/agent/.bumpversion.cfg
index 05d99468..3d046f43 100644
--- a/libs/python/agent/.bumpversion.cfg
+++ b/libs/python/agent/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.4.0
+current_version = 0.4.32
 commit = True
 tag = True
 tag_name = agent-v{new_version}
diff --git a/libs/python/computer/.bumpversion.cfg b/libs/python/computer/.bumpversion.cfg
index 32b7e60e..1cbb791b 100644
--- a/libs/python/computer/.bumpversion.cfg
+++ b/libs/python/computer/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.4.0
+current_version = 0.4.7
 commit = True
 tag = True
 tag_name = computer-v{new_version}
diff --git a/libs/python/core/.bumpversion.cfg b/libs/python/core/.bumpversion.cfg
index 14c00eb4..917e4cc8 100644
--- a/libs/python/core/.bumpversion.cfg
+++ b/libs/python/core/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.8
+current_version = 0.1.9
 commit = True
 tag = True
 tag_name = core-v{new_version}
diff --git a/libs/python/mcp-server/.bumpversion.cfg b/libs/python/mcp-server/.bumpversion.cfg
index 5c354295..abe0f5e2 100644
--- a/libs/python/mcp-server/.bumpversion.cfg
+++ b/libs/python/mcp-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.0
+current_version = 0.1.13
 commit = True
 tag = True
 tag_name = mcp-server-v{new_version}
diff --git a/libs/python/som/.bumpversion.cfg b/libs/python/som/.bumpversion.cfg
index 275c2177..232fe9f9 100644
--- a/libs/python/som/.bumpversion.cfg
+++ b/libs/python/som/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.0
+current_version = 0.1.3
 commit = True
 tag = True
 tag_name = som-v{new_version}

From 3d50e3cefb82b51427fdd63b34fb74b69ef0fef5 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 22:40:36 +0000
Subject: [PATCH 12/15] update pyproj

---
 libs/python/agent/pyproject.toml      | 2 +-
 libs/python/computer/pyproject.toml   | 2 +-
 libs/python/core/pyproject.toml       | 2 +-
 libs/python/mcp-server/pyproject.toml | 2 +-
 libs/python/som/pyproject.toml        | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/libs/python/agent/pyproject.toml b/libs/python/agent/pyproject.toml
index 718b8404..b9592f1f 100644
--- a/libs/python/agent/pyproject.toml
+++ b/libs/python/agent/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-agent"
-version = "0.4.0"
+version = "0.4.32"
 description = "CUA (Computer Use) Agent for AI-driven computer interaction"
 readme = "README.md"
 authors = [
diff --git a/libs/python/computer/pyproject.toml b/libs/python/computer/pyproject.toml
index 4a9b41bb..6b5b3381 100644
--- a/libs/python/computer/pyproject.toml
+++ b/libs/python/computer/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer"
-version = "0.4.0"
+version = "0.4.7"
 description = "Computer-Use Interface (CUI) framework powering Cua"
 readme = "README.md"
 authors = [
diff --git a/libs/python/core/pyproject.toml b/libs/python/core/pyproject.toml
index b9692162..c4bcd459 100644
--- a/libs/python/core/pyproject.toml
+++ b/libs/python/core/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-core"
-version = "0.1.8"
+version = "0.1.9"
 description = "Core functionality for Cua including telemetry and shared utilities"
 readme = "README.md"
 authors = [
diff --git a/libs/python/mcp-server/pyproject.toml b/libs/python/mcp-server/pyproject.toml
index f80a1b6b..ff4b5986 100644
--- a/libs/python/mcp-server/pyproject.toml
+++ b/libs/python/mcp-server/pyproject.toml
@@ -7,7 +7,7 @@ name = "cua-mcp-server"
 description = "MCP Server for Computer-Use Agent (CUA)"
 readme = "README.md"
 requires-python = ">=3.11"
-version = "0.1.0"
+version = "0.1.13"
 authors = [
     {name = "TryCua", email = "gh@trycua.com"}
 ]
diff --git a/libs/python/som/pyproject.toml b/libs/python/som/pyproject.toml
index 10b29ff8..f871eb18 100644
--- a/libs/python/som/pyproject.toml
+++ b/libs/python/som/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-som"
-version = "0.1.0"
+version = "0.1.3"
 description = "Computer Vision and OCR library for detecting and analyzing UI elements"
 authors = [
     { name = "TryCua", email = "gh@trycua.com" }

From d0404460b69613bd0e063759a3e0343cef080b5e Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 22:47:07 +0000
Subject: [PATCH 13/15] update readme

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0e6268f9..cd3d9a3a 100644
--- a/README.md
+++ b/README.md
@@ -268,7 +268,7 @@ make bump-all-patch           # Bumps patch version for ALL packages
 After running any bump command, push your changes:
 
 ```bash
-git push origin main
+git push origin main && git push origin --tags
 ```
 
 For more details, run `make help` or see the [Makefile](./Makefile).

From 20657611f7df3ac3d334efd3c71fa89fc0a465fa Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 10 Oct 2025 22:59:55 +0000
Subject: [PATCH 14/15] version correctness

---
 libs/python/pylume/.bumpversion.cfg   | 2 +-
 libs/python/pylume/pylume/__init__.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/pylume/.bumpversion.cfg b/libs/python/pylume/.bumpversion.cfg
index c57ee4cc..4a316b37 100644
--- a/libs/python/pylume/.bumpversion.cfg
+++ b/libs/python/pylume/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.2.2
+current_version = 0.2.1
 commit = True
 tag = True
 tag_name = pylume-v{new_version}
diff --git a/libs/python/pylume/pylume/__init__.py b/libs/python/pylume/pylume/__init__.py
index 5b3818ef..adfb15d9 100644
--- a/libs/python/pylume/pylume/__init__.py
+++ b/libs/python/pylume/pylume/__init__.py
@@ -35,7 +35,7 @@ from .models import (
 # Import main class last to avoid circular imports
 from .pylume import PyLume
 
-__version__ = "0.2.2"
+__version__ = "0.2.1"
 
 __all__ = [
     "PyLume",

From 6fd19404dc8a5da4ea81e311feb38654b0771db9 Mon Sep 17 00:00:00 2001
From: r33drichards <rwendt1337@gmail.com>
Date: Fri, 10 Oct 2025 17:18:07 -0700
Subject: [PATCH 15/15] version

---
 libs/python/computer-server/.bumpversion.cfg | 2 +-
 libs/python/computer-server/pyproject.toml   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/libs/python/computer-server/.bumpversion.cfg b/libs/python/computer-server/.bumpversion.cfg
index 369c7e05..831ffd2e 100644
--- a/libs/python/computer-server/.bumpversion.cfg
+++ b/libs/python/computer-server/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.1.26
+current_version = 0.1.24
 commit = True
 tag = True
 tag_name = computer-server-v{new_version}
diff --git a/libs/python/computer-server/pyproject.toml b/libs/python/computer-server/pyproject.toml
index 8735e51f..6468a48d 100644
--- a/libs/python/computer-server/pyproject.toml
+++ b/libs/python/computer-server/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "cua-computer-server"
-version = "0.1.26"
+version = "0.1.24"
 
 description = "Server component for the Computer-Use Interface (CUI) framework powering Cua"
 authors = [