JobFoundryAGPL-3.0
GitHub
Docs/Installation & Setup

Getting Started with JobFoundry

JobFoundry captures job listings from your browser, scores them against your profile using an LLM, and generates tailored ATS resumes — automatically. Scoring and tailoring are the core value. To unlock them you need an LLM API key (free tier options are available — seeLLM API Keys). Install JobFoundry first, then add your key in Settings.

✓What you need

A computer (Linux, Windows 11, or macOS), a browser (Firefox, Chrome, Edge, or Brave), and an LLM API key — this is what powers scoring and tailoring. Several providers offer free tier options with no credit card required. SeeLLM API Keys for a curated list. Job capture alone works without a key.

!Work in Progress / Beta

JobFoundry is built by a solo developer scratching his own itch during a hard job search. The core flows work, but rough edges exist and active progress is happening every day. Bug reports, testing, and feedback are deeply appreciated!

Method 1: One-line install with Docker or Podman (default & recommended)

On Linux, macOS, or Windows (WSL2), this single command sets up everything — automatically detecting whether you have docker compose, podman compose,podman-compose, docker-compose, or compatible container tools:

ONE-LINE INSTALL (DOCKER / PODMAN)
$ curl -fsSL https://raw.githubusercontent.com/Covai-Labs/JobFoundry/main/install.sh | bash

Then open http://localhost:8080in your browser to see the dashboard.

Method 2: Standalone desktop app (no containers needed)

If you prefer ready-made native desktop builds without Docker or Podman, download the latest release from theReleases page:

  • Linux: download JobFoundry-<version>-x86_64.AppImage, right-click → Properties → allow executing (or runchmod +x JobFoundry-*.AppImage once), then double-click to launch. The dashboard opens athttp://localhost:8080.Requires glibc 2.39+ (Fedora 40+, Ubuntu 24.04+, Debian 13+, Arch). For older distributions, use Method 1 (Docker/Podman). Convenience build — please report issues.
  • Windows 11: download JobFoundry-<version>-x64.msixand JobFoundry.cer. Right-click the Start button → Terminal (Admin) and trust the release certificate (repeat if a release uses a new certificate), then install the package.Convenience build — please report issues.
  • macOS (Apple Silicon): install via Homebrew:brew tap covai-labs/tap && brew install covai-labs/tap/jobfoundry, then launch with jobfoundry start. Or download the *-darwin-arm64.tar.gzRelease asset.For Intel Macs, use Method 1 (Docker). Convenience build — please report issues.
TRUST CERTIFICATE (ADMIN POWERSHELL)
$ Import-Certificate -FilePath .\JobFoundry.cer -CertStoreLocation Cert:\LocalMachine\TrustedPeople
INSTALL JOBFOUNDRY
$ Add-AppxPackage -Path .\JobFoundry-<version>-x64.msix

Then launch JobFoundry from the Start menu. Your data and settings live under %LOCALAPPDATA%\JobFoundry\, safely outside the app package.

Method 3: Manual setup (developers)

If you prefer to manage services yourself or contribute code:

CLONE REPOSITORY
$ git clone https://github.com/Covai-Labs/JobFoundry.git && cd JobFoundry

Copy the sample configuration and add your LLM provider key:

CONFIGURE ENVIRONMENT
$ cp .env.example .env

Start everything in the background:

START SERVICES (DOCKER)
$ docker compose up -d

Or with Podman:

START SERVICES (PODMAN)
$ podman compose up -d

For bare-metal development without containers (Node.js 26+, Python 3.12+,uv), see the Development Guidefor per-service commands.

Next: add the browser extension

The extension is what captures job postings as you browse — the server cannot do this part (by design). Easiest: install it from your browser's official store:

◈Store listings may lag behind GitHub Releases

Store reviews take time, so the store version can trail the latestGitHub Release. If you hit an issue, compare your installed version against the latest GitHub Release — and fall back to the manual .zip install below if you need the newest fix right away.

Manual fallback (latest build, no building required): download the prebuilt.zip from theReleases pageand load it:

  • Firefox: open about:debugging#/runtime/this-firefox, click Load Temporary Add-on…, and select the manifest file. Note: this manual install is temporary — Firefox removes it on restart, so prefer the signed store listing above for persistent installs.
  • Chrome / Edge / Brave: open chrome://extensions/, enable Developer mode, click Load unpacked, and select the unzipped folder.

Then: upload your resume and browse

  1. Open the dashboard at http://localhost:8080.
  2. Go to the Resume Manager and upload your master resume (JSON Resume format).
  3. Add your LLM key in Settings (or the .env file for manual installs) — this is what enables scoring and tailoring. See LLM API Keys for free options.
  4. Browse job sites normally. Listings flow into the dashboard, get scored, and appear on your Kanban board.
NEXT STEPInstall the Companion Browser Extension →