CodexLB - Windows Installer

🇨🇳 中文

This repository provides an automated Windows installer and headless launcher wrapper for the excellent Codex Load Balancer project by Soju06.

It packages the backend, frontend dashboard, and a portable Python runtime into a single, zero-dependency setup wizard.

---

🛠️ Wrapper Features

• 📦 Zero Dependencies: Bundles portable Python 3.13.5 and all dependencies. No system Python, Node, Git, or Docker setup required.
• 🤫 Headless Executable: Runs headlessly in the background without displaying a terminal command prompt.
• 🖥️ System Tray Icon: Runs in the system tray with Open Dashboard, Auto Update, and Quit options.
• 🌐 Auto-Launch Dashboard: Automatically pops up the dashboard (http://localhost:2455) in your default web browser on startup.
• 🔒 Single-Instance Mutex: Restricts execution to a single background process. Launching the shortcut again simply opens the browser redirect and exits.
• 🔄 Auto Update: Checks for new stable releases from GitHub and installs them silently. Only stable releases are installed — pre-releases are skipped.
• 🧹 Clean Uninstallation: Fully registers with Windows Add/Remove programs with a checkbox option to purge database settings (~/.codex-lb).
• 🌏 Multi-Language: Tray menu auto-detects Windows system language and uses Chinese (Simplified) when applicable.
• 🤖 Automated CI Releases: A scheduled GitHub Actions workflow checks the target repository for new releases daily, compiles the installer, and publishes the release binaries here automatically.

---

📥 Quick Start

1. Download the latest CodexLB_Installer.exe from the Releases tab.
2. Run the installer wizard and complete setup.
3. Launch the app from the Desktop or Start Menu shortcut.

---

🔄 Auto Update

CodexLB includes a built-in auto-update mechanism via the system tray:

• Manual: Right-click the tray icon → Check for Updates to check and install the latest stable release.
• Automatic: Enable Auto Update in the tray menu to check for updates on every startup. If a newer stable release is found, it downloads and installs silently in the background.

Only stable releases are installed — pre-release and beta versions are automatically skipped.

---

⚙️ Local Build Instructions

If you want to compile the installer package locally:

1. Clone this repository:

   git clone https://github.com/SpookySandwich/codex-lb-installer.git
   cd codex-lb-installer

2. Clone the target repository:

   git clone https://github.com/Soju06/codex-lb.git codex-lb-src

3. Build the React frontend assets in codex-lb-src/frontend:

   cd codex-lb-src/frontend
   npm install && npm run build
   cd ../..

4. Run the builder script (requires Go, Python with uv on PATH, and Pillow):

   pip install Pillow
   python bundle_build.py

5. Grab your compiled installer in the dist/ directory!

---

📜 Credits & Licensing

• Core Application: All credits for the load balancer, dashboard proxy, and API logic go to the original Soju06/codex-lb project.
• Wrapper License: MIT License.