Download & install

Get the code

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

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.

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

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

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

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. 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. 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. 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. 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.