Home/Docs/Per iniziare

🚀 Per iniziare

Da zero a un team operativo in circa 10 minuti

Job Hunter Team è una squadra di agenti AI che cercano, valutano, assegnano un punteggio e personalizzano le candidature per te, 24 ore su 24. Questa pagina lo mette in funzione.

⚡ Il percorso più veloce: se usi già un assistente AI (Claude Code, OpenClaw, Codex, Cursor…), basta indirizzarlo a questa guida e al repo e chiedergli di configurare tutto. L'intera CLI è progettata per essere guidata da un agente — potresti non dover digitare nemmeno un comando.

🧠 Prima di tutto, un abbonamento

Il team funziona con un abbonamento LLM, non con chiavi API a consumo — lavora 24 ore su 24 e ciò diventerebbe costoso. Ti serve un piano attivo con uno dei tre provider:

🌙 Kimi (Moonshot) — la fascia più semplice da cui partire.
🔵 Codex (OpenAI) — un equilibrio tra qualità e costo.
🟠 Claude (Anthropic) — la massima precisione, ideale per scoring e scrittura.

⚠️ Dedica l'abbonamento al team. Non riutilizzare lo stesso account che usi per l'AI personale — condividono un'unica quota settimanale e il team raggiungerà i limiti in modo imprevisto. Maggiori dettagli sulla pagina dei prezzi.

🛤️ Poi, scegli come installare

🦞 Percorso 1 — Lascia fare al tuo assistente AI

Se usi un assistente di programmazione, digli qualcosa come:

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

Leggerà la documentazione, installerà la CLI, eseguirà jht doctor, sistemerà ciò che manca e avvierà il team. Questo è un obiettivo di progettazione primario, non un trucco.

🖥️ Percorso 2 — App desktop (in arrivo)

Un launcher grafico per macOS, Windows e Linux è in arrivo: installerà tutto e avvierà il team con un clic, senza terminale. Non è ancora scaricabile — lo trovi segnalato sulla pagina di installazione. Nel frattempo usa il Percorso 1 o il Percorso 3.

📦 Percorso 3 — Installer one-liner

macOS / Linux / WSL2:

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

Windows (PowerShell, Docker Desktop deve essere già in esecuzione):

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

Poi avvia il team ed esegui la procedura guidata:

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

L'unico requisito è Docker — l'installer configura il runtime su macOS e Linux per te (su Windows si aspetta Docker Desktop già installato). Niente Node, Python o tmux sulla tua macchina: tutto vive dentro il container.

🎬 La tua prima esecuzione

Qualunque percorso tu abbia scelto:

Configura il tuo profilo. Chatta con l'Assistente nell'onboarding al primo avvio — scriverà il tuo candidate_profile.yml.
Forniscigli i tuoi avvisi di lavoro (opzionale ma consigliato) — vedi Inoltro email.
Clicca Start. Il Capitano coordina Scout → Analista → Scorer → Scrittore → Critico; la Sentinella mantiene tutti entro la finestra dell'abbonamento.
Esamina i risultati dashboard. Nulla viene mai inviato automaticamente — decidi tu cosa inviare.

🩹 Bloccato? jht doctor ti dice esattamente cosa manca. Per la configurazione sempre attiva vedi Esegui 24/7 su un VPS.

Going deeper

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