Avant de commencer
Postyli s'utilise en ligne ou installé sur votre ordinateur. Les étapes sont les mêmes ; seules quelques options avancées changent.
Version en ligne
Rien à installer : ouvrez l'application et commencez. Quelques fonctions sensibles (édition LaTeX brute, Ollama) sont désactivées et l'envoi d'emails est plafonné.
Installation locale
Lancez ./start.sh (ou start.bat sous Windows) puis ouvrez http://localhost:5173. Toutes les fonctions sont actives et les limites d'envoi levées.
L'accueil présente les offres : chacune a sa page, avec son adresse à partager. Sur une offre, Adapter le CV et postuler adapte votre CV, crée le PDF et ouvre directement l'envoi. Mon CV, dans la barre du haut, rassemble les quatre étapes de la candidature : la frise en haut de ces pages marque chaque étape terminée d'une coche, et vous pouvez revenir à n'importe laquelle, votre travail est conservé.
Choisir un mode d'IA
Ouvrez Paramètres (l'icône ⚙ de la barre du haut), onglet Intelligence artificielle. Le mode choisi sert à adapter le CV et à rédiger les lettres.
| Fournisseur | Clé API | Idéal pour |
|---|---|---|
| Heuristique | Aucune | Démarrer tout de suite, 100 % hors-ligne. Trie vos expériences par mots-clés, sans rédaction. |
| Google Gemini | aistudio.google.com | Excellent rapport qualité/vitesse avec gemini-2.5-flash. |
| OpenAI | platform.openai.com | gpt-4o-mini, bon rapport coût/qualité. |
| Groq | console.groq.com (gratuite) | Itérations très rapides. |
| DeepSeek | platform.deepseek.com | Bonne compréhension du contexte. |
| Ollama | Aucune | Modèles 100 % privés sur votre machine. Installation locale uniquement. |
Le mode Heuristique suffit pour un premier CV. Pour générer les lettres de motivation, les modèles de lettre ou un contenu traduit en anglais, choisissez un fournisseur d'IA.
Profil Maître
Votre profil complet, saisi une seule fois. Il sert de source à tous les CV ciblés : soyez exhaustif, l'adaptation choisira ce qui compte pour chaque offre.
Trois façons de le remplir
Importer un CV
Importer un CV extrait automatiquement vos infos depuis un PDF ou un code source LaTeX.
Saisie manuelle
Contact, résumé, expériences (une réalisation par ligne), compétences par familles, formations, projets, langues, certifications.
Exemple
Remplacer par le profil d'exemple, dans le menu ⋯, charge un profil de démonstration pour découvrir l'outil.
Sauvegarder votre profil
Le profil est enregistré automatiquement dans votre navigateur. Pour le garder en sécurité ou le transférer sur un autre ordinateur :
- Télécharger une sauvegarde (.json), dans le menu ⋯, enregistre votre profil dans un fichier.
- Restaurer une sauvegarde recharge un profil depuis ce fichier.
Vider les données du navigateur efface le profil. Exportez une sauvegarde après chaque grosse modification.
Ciblage & Adaptation
Collez une offre d'emploi : Postyli en extrait l'intitulé et les mots-clés ATS, puis réorganise et reformule votre profil pour ce poste.
- Collez le texte complet de l'offre (ou cliquez sur Charger un exemple pour tester). Depuis une offre de l'accueil, ce texte est rempli pour vous.
- Cliquez sur Voir les mots-clés pour voir l'intitulé détecté et les compétences recherchées.
- Cliquez sur Adapter mon CV. Postyli crée ensuite le PDF et ouvre l'étape Envoi, qui rappelle le poste ciblé et le score de correspondance.
Zéro hallucination : l'adaptation réordonne et reformule uniquement ce qui est dans votre profil. Aucune expérience, diplôme ou chiffre n'est inventé.
Rendu & Export PDF
Choisissez l'apparence et la langue, compilez, puis téléchargez un PDF de qualité typographique.
| Gabarit | Style |
|---|---|
| Moderne & Épuré | Élégant, touches de bleu, hiérarchie claire, optimisé ATS. |
| Classique Corporate | Corporate / académique, police à empattement. |
| Minimaliste 1-Page | Compact et dense, calibré pour tenir sur une page. |
| Personnalisé (IA) | Collez votre propre LaTeX, l'IA y injecte vos données. Installation locale uniquement. |
- Choisissez le gabarit et la langue (FR ou EN). Les titres sont traduits ; avec une IA, le contenu adapté l'est aussi.
- Cliquez sur Générer le PDF et vérifiez l'aperçu.
- Cliquez sur Télécharger le PDF.
L'onglet LaTeX montre le code source généré. En installation locale, vous pouvez le modifier puis recompiler pour un réglage au millimètre.
Configurer Gmail
Pour envoyer vos candidatures, Postyli se connecte à votre compte Gmail avec un mot de passe d'application, jamais votre mot de passe habituel.
- Activez la validation en 2 étapes sur votre compte Google (obligatoire pour les mots de passe d'application).
- Créez un mot de passe d'application sur myaccount.google.com/apppasswords. Google affiche 16 caractères.
- Ouvrez Paramètres, onglet Email, saisissez votre adresse Gmail et ce mot de passe.
- Cliquez sur Tester la connexion (aucun email n'est envoyé), puis Enregistrer. Le point jaune à côté de Paramètres disparaît.
Le mot de passe reste uniquement dans cet onglet et s'efface à sa fermeture. Il n'est jamais enregistré sur le serveur. Vous pouvez le révoquer à tout moment depuis votre compte Google.
Candidature
Deux modes, accessibles par les onglets en haut de l'étape 4.
Pour l'offre visée
Une lettre écrite sur mesure pour l'offre de l'étape 2, envoyée à un recruteur.
Envoi groupé
Une lettre réutilisable, personnalisée automatiquement pour une adresse ou toute une liste CSV.
Mode « Pour l'offre visée »
- Le CV adapté est joint tout seul : changez de modèle ou de langue à l'étape 3 si besoin.
- Cliquez sur Rédiger avec l'IA. Relisez et modifiez l'objet et le texte à votre guise.
- Saisissez l'adresse du recruteur, puis Envoyer la candidature.
Si vous changez d'offre ou de langue, la lettre est signalée comme écrite pour une autre offre : régénérez-la avant d'envoyer.
Envoi groupé
Écrivez une lettre une fois, Postyli la personnalise pour chaque destinataire et envoie les emails un par un, espacés pour protéger votre compte Gmail.
1. Préparer le modèle
Choisissez un modèle de départ (FR ou EN), créez-en un avec Nouveau, ou laissez l'IA le rédiger avec Générer avec l'IA. Utilisez ces variables dans l'objet et le texte :
| Variable | Remplacée par |
|---|---|
{entreprise} | Colonne « entreprise » du CSV |
{poste} | Colonne « poste » du CSV |
{contact} | Colonne « contact » du CSV (nom du recruteur) |
{nom} | Votre nom, tiré du profil |
{contact|Madame, Monsieur} | Valeur par défaut si la case est vide |
Cliquez sur Enregistrer le modèle : l'envoi utilise toujours la version enregistrée. Écrivez {{ et }} pour obtenir des accolades littérales.
2. Choisir les destinataires
Saisissez une adresse (avec entreprise, poste et contact) puis Utiliser cette adresse, ou Importer un CSV. La première ligne doit contenir les noms de colonnes ; seule email est obligatoire :
email;entreprise;poste;contact
rh@acme.fr;ACME;Data Engineer;Mme Martin
jobs@globex.com;Globex;Développeur Python;
talents@initech.io;Initech;;M. Durand
- Séparateur
,ou;. Les CSV enregistrés par Excel (accents compris) sont acceptés. 200 Ko maximum. - Les adresses invalides et les doublons sont écartés automatiquement.
- Les adresses déjà contactées depuis ce navigateur sont exclues, sauf si vous cochez « Recontacter quand même ».
- Un destinataire dont une variable sans valeur par défaut est vide est ignoré : jamais de « Bonjour , ».
3. Vérifier puis lancer
- Parcourez l'Aperçu avec les flèches : chaque email est affiché tel qu'il partira.
- Choisissez le CV joint : le CV compilé à l'étape 3 ou un PDF importé.
- Réglez le délai entre deux envois. Il varie de ±20 % à chaque email pour un rythme naturel ; restez au-dessus de 30 s.
- Cliquez sur Lancer l'envoi, vérifiez le récapitulatif (nombre, durée estimée) et confirmez.
4. Suivre l'envoi
La carte Progression indique chaque statut et le compte à rebours avant le prochain email.
- Pause / Reprendre : suspend la file sans rien perdre.
- Arrêter : annule les emails restants. Nouvel envoi repart de zéro.
- Si Gmail refuse la connexion, l'envoi se met en pause : corrigez le mot de passe, puis reprenez.
- Onglet fermé ou rechargé ? La progression est conservée : sélectionnez à nouveau le CV puis reprenez. Un email en cours au moment de la fermeture est marqué « Échec » pour ne jamais être envoyé deux fois : vérifiez vos messages envoyés.
Gardez l'onglet ouvert pendant l'envoi : c'est votre navigateur qui pilote la file.
Suivre vos envois
Cochez Suivre l'ouverture de ce mail avant d'envoyer, puis ouvrez Tableau de bord, dans « Mon espace », pour savoir quels recruteurs ont ouvert votre candidature.
- La case est décochée par défaut, dans les deux modes d'envoi. Elle n'apparaît que sur un serveur en ligne configuré pour le suivi.
- Choisissez la période en haut : 24 h, 3 jours, 7 jours, 30 jours, 90 jours ou Tout. Les envois comptent à leur date d'envoi, les ouvertures à leur date d'ouverture.
- Cliquez sur une ligne du tableau pour voir chaque ouverture. Exporter en CSV, dans le menu ⋯, produit un fichier lisible par Excel.
- Le tableau se met à jour tout seul chaque minute tant qu'il est affiché : une candidature ouverte reçoit son tampon Ouvert, daté. Actualiser force une mise à jour.
Mesure approximative : Gmail peut sous-compter, Apple Mail peut compter des ouvertures automatiques, Outlook bloque souvent les images. Afficher votre propre copie dans « Envoyés » compte aussi.
L'historique des envois reste dans ce navigateur. Vider l'historique le supprime : les statistiques ne sont alors plus consultables.
Données & confidentialité
Vos données restent dans votre navigateur. Le serveur ne conserve que des compteurs anonymes : ceux du suivi d'ouverture, si vous l'activez, et ceux des limites d'envoi.
| Donnée | Où elle est gardée |
|---|---|
| Profil, offre, langue | Votre navigateur (localStorage), jusqu'à ce que vous l'effaciez. |
| Paramètres IA et clé API | Votre navigateur. La clé est transmise au serveur uniquement le temps d'une requête IA. |
| Mot de passe Gmail | Cet onglet seulement (sessionStorage), effacé à sa fermeture. |
| Modèles, adresses contactées, progression d'envoi | Votre navigateur. Jamais d'identifiants ni de PDF dans la progression. |
| PDF générés | Renvoyés directement au navigateur, jamais stockés sur le serveur. |
| Suivi d'ouverture (si activé) | Serveur : jetons aléatoires, dates et nombre d'ouvertures, sans destinataire ni objet, supprimés après 90 jours. L'historique des envois reste dans votre navigateur. |
| Limites d'envoi | Serveur : une empreinte chiffrée de votre adresse IP (jamais l'adresse elle-même) et l'heure de chaque envoi, effacées après 24 heures. |
| Mesure d'audience | Vercel Web Analytics compte les visites de façon agrégée (pages vues, pays, type d'appareil), sans cookie publicitaire. |
Limites
La version en ligne est partagée : des garde-fous empêchent les abus. En local, ils sont levés.
| En ligne | Installation locale | |
|---|---|---|
| Envois par minute | 5 | Illimité |
| Envois par jour | 100 (seuls les envois réussis comptent) | Illimité |
| Destinataires par envoi groupé | 50 | Illimité |
| Délai minimum entre deux emails | 30 s | 5 s |
| Édition LaTeX, gabarit personnalisé, Ollama | Désactivés | Activés |
Dans tous les cas, Gmail plafonne les comptes personnels à environ 500 destinataires par jour.
FAQ & dépannage
Les situations les plus fréquentes et comment les résoudre.
« Gmail a refusé la connexion »
Vérifiez que vous utilisez bien un mot de passe d'application (16 caractères) et non votre mot de passe Google, que la validation en 2 étapes est active et que l'adresse est correcte. Utilisez Tester la connexion pour valider sans rien envoyer.
« Trop d'envois » ou « Limite quotidienne atteinte »
Vous avez atteint une limite de la version en ligne. Un envoi groupé réessaie automatiquement une fois après une minute, puis se met en pause. Pour envoyer davantage, installez Postyli en local.
Le bouton de rédaction indique « Choisir une IA pour rédiger »
La rédaction de lettres nécessite un fournisseur d'IA. Ouvrez Paramètres, onglet Intelligence artificielle, choisissez Gemini, OpenAI, Groq, DeepSeek ou Ollama et renseignez la clé. En mode « Pour l'offre visée », une offre doit aussi être collée à l'étape 2.
Mon CSV est refusé : « Colonne email introuvable »
La première ligne doit contenir les noms de colonnes. Sont reconnus : email, e-mail, mail, courriel pour l'adresse ; entreprise, société, company ; poste, intitulé, job ; contact, recruteur, name.
Certains destinataires sont « ignorés : variables manquantes »
Le modèle utilise une variable (par ex. {poste}) vide pour ces lignes. Complétez le CSV ou ajoutez une valeur par défaut : {poste|candidature spontanée}.
La compilation du PDF échoue
Le message d'erreur LaTeX s'affiche sous l'aperçu. Essayez un autre gabarit, raccourcissez un texte très long, ou si vous avez modifié le LaTeX à la main, annulez la dernière modification. Les caractères spéciaux (&, %, #, C++…) sont gérés automatiquement.
Le CV est-il compatible avec les logiciels de recrutement (ATS) ?
Oui. Les gabarits produisent un PDF au texte sélectionnable et l'adaptation reprend les mots-clés de l'offre. Le gabarit Moderne & Épuré est spécialement optimisé pour la lecture ATS.
J'ai perdu mon profil
Le profil vit dans le navigateur : il disparaît si vous videz ses données ou changez de navigateur. Utilisez Restaurer une sauvegarde avec votre dernière sauvegarde .json, ou réimportez votre CV.