Install · local Hub

Download & install

Desktop Hub for Windows, macOS, and Linux. No fake installers and no invented per-OS download buttons. Today: clone (or a GitHub source archive) and run the launcher. Frozen Win / Mac / Linux zips land on GitHub Releases only after the first v* tag (Actions).

Detecting your OS…

Checking GitHub Releases for desktop zips…

Get the code

This page does not invent asset URLs. Platform zips (CareerHound-v*-win.zip, -macos.zip, -linux.zip) appear on GitHub Releases after someone pushes a v* tag and Actions finishes. Until that list is non-empty, use clone or a source archive plus CareerHound.bat / ./careerhound.sh (or Launch.bat / launch.sh). Offline demo: append --demo (see OS notes and Docs → Demo mode).

GitHub Releases

Checking whether any published release has desktop zip assets…

Open Releases

Clone (works now)

Recommended until the first tagged release publishes frozen zips. Clone, then run the launcher from the project root.

git clone https://github.com/jacobdcook/linkedin-automator.git
cd linkedin-automator

Launch by OS

Same Hub on all three. Detected platform is highlighted. From a source checkout, launchers create .venv, install deps on first run, then open the Hub. From a frozen zip (when published), run the binary and follow FIRST_RUN.txt.

Windows

From a source checkout, double-click CareerHound.bat or Launch.bat, or from PowerShell in the project folder:

CareerHound.bat
.\Launch.bat
.\launch.ps1

Needs Python 3.10+ on PATH (py or python). During Python setup, check “Add python.exe to PATH”. Offline demo (no LinkedIn): CareerHound.bat --demo or Launch.bat --demo. Frozen zip (when listed on Releases): run CareerHound.exe.

Clone / source Python for Windows

macOS

From a source checkout, in Terminal:

chmod +x careerhound.sh launch.sh
./careerhound.sh
# or: ./launch.sh

Install only (no Hub): ./launch.sh --no-hub. Offline product tour (no LinkedIn login): ./careerhound.sh --demo or ./launch.sh --demo. Homebrew Python 3.10+ works fine. Frozen zip (when listed on Releases): open the app / binary and read FIRST_RUN.txt.

Clone / source Python for macOS

Linux

From a source checkout, in a shell:

chmod +x careerhound.sh launch.sh
./careerhound.sh
# or: ./launch.sh

Or use the venv wrapper later: python careerhound_hub.py. Offline demo (mock queue, dashboard, jobs; no LinkedIn): ./careerhound.sh --demo or ./launch.sh --demo. Hub sets XMODIFIERS=@im=none for its process so Tk typing works with IBus. Frozen zip (when listed on Releases): ./CareerHound.

Clone / source Linux notes in Docs

System requirements

Local-first. Your machine runs the Hub; contacts and drafts stay on disk. We never log into LinkedIn.

  • Python 3.10+ Required. Install from python.org or your package manager. Windows: add to PATH.
  • OS Windows 10/11, macOS (Intel or Apple Silicon), or a modern Linux desktop.
  • Disk & network Room for a venv. Outbound HTTPS for AI providers you choose, FastSpring checkout, and optional license / GitHub update checks.
  • LinkedIn data export Import LinkedIn’s official CSV archive. CareerHound never logs into LinkedIn. You send in your own browser.
  • AI (optional but recommended) Ollama locally, or Claude / Groq with your own API key. Templates fall back if the provider is down.

Get started in 60 seconds

Rough path from empty folder to Hub (source checkout). First launch may take longer while packages install. Frozen zip path (when assets exist): unzip, run the binary, follow FIRST_RUN.txt.

  1. Install Python 3.10+

    Confirm with python --version, py -3 --version, or python3 --version. Skip this if you already have a published frozen zip for your OS.

  2. Get the project

    Until GitHub Releases lists platform zip assets, clone the repo (or download a source archive from GitHub). Do not expect Win / Mac / Linux binaries on an empty Releases page. Open the project root.

  3. Run the launcher

    Windows: CareerHound.bat / Launch.bat or .\launch.ps1. macOS / Linux: ./careerhound.sh / ./launch.sh. Offline demo: ./launch.sh --demo (or CareerHound.bat --demo). Frozen: CareerHound.exe / app / ./CareerHound.

  4. Finish first-run

    First launch asks for email. Start Free licenses that email to this PC. A new Gmail on the same machine will not reset the Free seat. Staff founder trials (Mac and Jacob only) Sign in with email + password. Everyone else pastes a FastSpring Pro key to upgrade. Then pick an AI provider, import your LinkedIn CSV export, and use the Action Queue (copy + open profile). Trial passwords are not published here.

Clone / source Open Releases Docs: Getting Started FAQ

What you will not find here

This page does not host fake one-click installers or made-up download links. It only wires direct zip buttons when the GitHub Releases API reports real CareerHound-v*-{win|macos|linux}.zip assets. Until then, Releases is treated as empty: clone or use a source archive plus CareerHound.bat / ./careerhound.sh (or Launch.bat / launch.sh). Checkout for Pro / Team stays on FastSpring from the pricing page; keys activate in Hub → Settings → License. Founder email + password Sign in is staff-only (Mac and Jacob); public users stay on Free or a purchase key. This site never lists trial passwords.