Make it installable: Add comprehensive documentation and Multi-platform Release distribution workflow

Author: Armaldio

.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release Build Distribution
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    name: Compile for ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+            artifact_name: gpupatch.exe
+            asset_name: gpupatch-windows-amd64.exe
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            artifact_name: gpupatch
+            asset_name: gpupatch-linux-amd64
+          - os: macos-latest
+            target: x86_64-apple-darwin
+            artifact_name: gpupatch
+            asset_name: gpupatch-macos-amd64
+          - os: macos-latest
+            target: aarch64-apple-darwin
+            artifact_name: gpupatch
+            asset_name: gpupatch-macos-arm64
+
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          target: ${{ matrix.target }}
+          override: true
+
+      - name: Compile Production Binary
+        run: cargo build --release --target ${{ matrix.target }}
+
+      - name: Stage Assets for Upload
+        shell: bash
+        run: |
+          if [ "${{ matrix.os }}" = "windows-latest" ]; then
+            cp target/${{ matrix.target }}/release/${{ matrix.artifact_name }} ./${{ matrix.asset_name }}
+          else
+            cp target/${{ matrix.target }}/release/${{ matrix.artifact_name }} ./${{ matrix.asset_name }}
+            chmod +x ./${{ matrix.asset_name }}
+          fi
+
+      - name: Upload to GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: |
+            ${{ matrix.asset_name }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -0,0 +1,46 @@
+# gpupatch 🚀
+
+A highly optimized, dependency-free Rust engine for hot-patching Windows Portable Executable (PE) binaries to enforce high-performance discrete GPU utilization.
+
+[![Rust PE Patcher Verification](https://github.com/CynToolkit/gpupatch/actions/workflows/ci.yml/badge.svg)](https://github.com/CynToolkit/gpupatch/actions/workflows/ci.yml)
+
+## Features
+- ⚡ **Blazing Fast**: Native Rust implementation with zero external runtime dependencies.
+- 🔬 **Ultra Reliable**: Passes 100% bitwise parity tests against reference C# implementation and performs safely even on heavyweight (100MB+) Chromium/Electron browser shells.
+- 📦 **Modern PE Handling**: Complies strictly with official PE specification regarding ordinal sorting and manifest preservation.
+- 💉 **Safe Injection**: Seamlessly injects `NvOptimusEnablement` and `AmdPowerXpressRequestHighPerformance` symbols into preexisting massive export tables.
+- 🔥 **In-Place Patching**: Intelligently toggles symbols in-place on previously patched binaries instead of expanding executable footprint.
+
+## Installation
+
+### Option 1: Direct Install via Cargo (Recommended)
+If you have Rust installed, you can compile and install globally with a single command:
+```bash
+cargo install --git https://github.com/CynToolkit/gpupatch.git
+```
+
+### Option 2: Building from Source
+```bash
+git clone https://github.com/CynToolkit/gpupatch.git
+cd gpupatch
+cargo build --release
+```
+The compiled binary will be available at `./target/release/gpupatch` (or `gpupatch.exe` on Windows).
+
+## Usage
+
+To force an executable to utilize the dedicated high-performance GPU:
+```bash
+gpupatch <input.exe> [<output.exe>]
+```
+
+To undo the patch:
+```bash
+gpupatch <input.exe> --disable
+```
+
+## Testing
+The test suite includes unit test verification and deterministic parity simulation:
+```bash
+cargo test
+```