diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 0000000..b0631d1
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,34 @@
+name: publish
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml
+
+  pr-build:
+    needs: ci
+    uses: ./.github/workflows/pr-build.yml
+
+  pypi-upload:
+    needs: pr-build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v6
+
+      - name: Upload ignition-api to PyPI
+        uses: coatl-dev/actions/pypi-upload@v5
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN_JAVA_API_PKG }}
+          working-directory: java-api
+
+      - name: Upload ignition-api-stubs to PyPI
+        uses: coatl-dev/actions/pypi-upload@v5
+        with:
+          python-version: '3.12'
+          password: ${{ secrets.PYPI_API_TOKEN_JAVA_API_STUBS }}
+          working-directory: java-api-stubs
diff --git a/java-api-stubs/README.md b/java-api-stubs/README.md
index efd8294..689b719 100644
--- a/java-api-stubs/README.md
+++ b/java-api-stubs/README.md
@@ -6,14 +6,14 @@ files were generated using `mypy`'s [`stubgen`].
 ## Installation and usage
 
 To use java-api-stubs, you may install it with `pip`. It requires Python
-3.7+ through 3.12.
+3.7 through 3.12.
 
 > [!WARNING]
 > Python 3.13 will not be supported.
 
 ```sh
 python3 -m pip install \
-    git+https://github.com/ignition-devs/java-api-17.git#subdirectory=java-api-stubs \
+    java-api-stubs \
     "mypy[python2]==0.971"
 ```
 
diff --git a/java-api/README.md b/java-api/README.md
index 3454b0a..ceb06c5 100755
--- a/java-api/README.md
+++ b/java-api/README.md
@@ -32,7 +32,7 @@ The preferred method is to install it by running `pip`. It requires Python
 2.7.18.
 
 ```bash
-python2 -m pip install git+https://github.com/ignition-devs/java-api-17.git#subdirectory=java-api
+python2 -m pip install java-api
 ```
 
 This will install it as package to your Python installation, which will allow
@@ -41,8 +41,8 @@ completion using an IDE such as PyCharm and Visual Studio Code.
 
 ```bash
 $ python2
-Python 2.7.18 (default, Nov  9 2020, 16:23:15)
-[GCC Apple LLVM 12.0.0 (clang-1200.0.32.21)] on darwin
+Python 2.7.18 (default, Sep 23 2024, 13:23:35)
+[GCC Apple LLVM 16.0.0 (clang-1600.0.26.3)] on darwin
 Type "help", "copyright", "credits" or "license" for more information.
 >>> from __future__ import print_function
 >>> import java.lang