Home/Docs/Getting Started

🚀 Getting Started

From zero to a running team in about 10 minutes

Job Hunter Team is a team of AI agents that hunt, vet, score and tailor job applications for you, around the clock. This page gets it running.

⚡ The fastest path: if you already use an AI assistant (Claude Code, OpenClaw, Codex, Cursor…), just point it at this guide and the repo and ask it to set everything up. The whole CLI is built to be driven by an agent — you may not have to type a single command yourself.

🧠 First, one subscription

The team runs on an LLM subscription, not pay-per-use API keys — it works around the clock and that would get expensive. You need an active plan with one of three providers:

🌙 Kimi (Moonshot Pro, ~€40/mo) — the affordable, mass-market tier. A great place to start.
🔵 Codex (OpenAI Plus/Pro, ~€100/mo) — a balance of quality and cost.
🟠 Claude (Anthropic Max x20, ~€200/mo) — the highest precision, best for scoring and writing.

⚠️ Dedicate the subscription to the team.Don't reuse the same account you use for personal AI — they share one weekly quota and the team will hit limits unexpectedly. More on the pricing page.

🛤️ Then, pick how you install

🦞 Path 1 — Let your AI assistant do it

If you use a coding assistant, tell it something like:

"Set up Job Hunter Team from
github.com/leopu00/job-hunter-team for my profile.
I have a [Kimi Pro / Codex / Claude Max] subscription.
Walk me through what you need."

It will read the docs, install the CLI, run jht doctor, fix what's missing and start the team. This is a primary design goal, not a hack.

🖥️ Path 2 — Desktop app (no terminal)

Download the launcher from the download page (macOS .dmg, Windows .exe, Linux .AppImage/.deb). Open it, then the wizard:

Picks your language and installs the container runtime for you.
Signs you into your provider through an embedded terminal.
Click Start — the team boots and your browser opens on the dashboard.

💡 The desktop app is the on/off switch and setup wizard, not where you read results. After it starts the team you interact via the web dashboard, Telegram or the CLI.

📦 Path 3 — One-liner installer

macOS / Linux / WSL2:

curl -fsSL https://jobhunterteam.ai/install.sh | bash

Windows (PowerShell, Docker Desktop must already be running):

iwr -useb https://jobhunterteam.ai/install.ps1 | iex

Then bring the team up and run the wizard:

jht up            # start the container (pulls the image first run)
jht setup         # wizard: provider, OAuth login, team start
jht doctor        # check everything is healthy
jht team status   # confirm it's running

The one requirement is Docker — the installer sets up the runtime on macOS and Linux for you (on Windows it expects Docker Desktop already installed). No Node, Python or tmux on your machine: everything lives inside the container.

🎬 Your first run

Whichever path you took:

Set up your profile. Chat with the Assistant at /onboarding — it writes your candidate_profile.yml for you.
Feed it your job alerts (optional but recommended) — see Email Forwarding.
Click Start. The Captain dispatches Scout → Analyst → Scorer → Writer → Critic; the Sentinel keeps everyone within the subscription window.
Review the output from the dashboard. Nothing is ever submitted automatically — you decide what to send.

🩹 Stuck? jht doctortells you exactly what's missing. For the always-on setup see Run 24/7 on a VPS.

Going deeper

These docs are the essentials. For the full detail, the exact flags and the code itself, read the source: QUICKSTART.md ↗

caricamento…