Skip to content

PSMAS30/caf-cpam-assistant

Repository files navigation

🏥 Assistant CAF/CPAM — Agent IA avec mémoire de dossier

Live Demo Python Claude API Streamlit License: MIT

En 30 secondes : Vous recevez un courrier de la CAF ou de la CPAM. Vous ne comprenez pas ce qu'on vous demande. Cet agent lit le courrier, vous explique ce qui se passe, et rédige la réponse pour vous — en tenant compte de tout ce que vous avez déjà échangé avec eux.

Projet #1 / 6 de la série Claude pour la France — un cas d'usage concret par mois.

👉 Tester la démo sans installation →


Le problème que ça résout

En France, des millions de personnes reçoivent chaque année des courriers de la CAF, CPAM, URSSAF ou autres qu'ils ne comprennent pas :

  • Jargon administratif inaccessible
  • Délais courts avec des conséquences graves si on les rate
  • Dossiers qui s'étalent sur des mois avec de nombreux allers-retours
  • Risque de trop-perçu, de suspension d'allocations, de perte de remboursements

Ce que fait cet agent :

  1. Analyse : lit votre courrier et vous explique ce qu'on vous demande, en clair
  2. Alerte : identifie les délais urgents et les risques si vous ne répondez pas
  3. Mémoire : retient tous vos échanges précédents pour garder le fil de votre dossier
  4. Rédaction : génère une réponse complète et professionnelle, adaptée à votre situation
  5. Conseil : analyse globale de votre dossier à tout moment
  6. Escalade automatique : remonte l'urgence à J-7 automatiquement, même si le courrier semblait peu urgent à l'arrivée

Démo rapide (sans installation)

L'interface web est déployée sur Streamlit Cloud avec 3 courriers d'exemple pré-chargés. Aucune clé API requise pour la démo — entrez la vôtre pour tester avec vos vrais courriers.

caf-cpam-assistant.streamlit.app


Prérequis

  • Python 3.10 ou supérieur
  • Une clé API Anthropic (gratuit pour commencer sur console.anthropic.com)
  • 5 minutes

Installation

# 1. Cloner le repo
git clone https://github.com/PSMAS30/caf-cpam-assistant
cd caf-cpam-assistant

# 2. Installer les dépendances
pip install -r requirements.txt

# 3. Configurer votre clé API
export ANTHROPIC_API_KEY="votre-clé-api"
# Sur Windows : $env:ANTHROPIC_API_KEY="votre-clé-api"

# 4. Lancer l'interface web
streamlit run app.py

# Ou l'interface CLI
python main.py statut

Utilisation CLI

Cas typique : vous recevez un courrier

# Option 1 — vous avez un PDF
python main.py ajouter courrier_caf.pdf

# Option 2 — vous copiez-collez le texte
python main.py ajouter
# (collez le texte, puis Ctrl+D)

Exemple de sortie :

✅ Courrier #1 ajouté au dossier
────────────────────────────────────
📌 Organisme   : CAF
📋 Type        : Demande de pièces justificatives
📖 Résumé      : La CAF vous demande 4 documents pour traiter votre demande
                 d'allocation logement. Vous avez 30 jours pour les fournir.
🚦 Urgence     : ÉLEVÉ

🎯 Actions requises :
   • Fournir votre avis d'imposition 2024 ← avant le 11 juin 2026 🔴
   • Fournir votre contrat de bail
   • Fournir une pièce d'identité
   • Fournir un RIB

Architecture

caf-cpam-assistant/
├── app.py                          Interface Streamlit (6 onglets)
├── main.py                         Interface CLI (8 commandes)
├── agent.py                        Agent principal — appels Claude
├── agent_extended.py               Extension : transparence + confiance
├── dossier.py                      Mémoire persistante (JSON local)
├── extractor.py                    Extraction texte PDF / TXT
├── prompts.py                      Prompts système (analyste, rédacteur, conseiller)
├── prompts_v2.py                   Prompts v2 avec scores de confiance
├── modules/
│   ├── transparency.py             Scores de confiance + citations sources
│   ├── urgency_escalator.py        Escalade automatique J-7
│   └── ingestion/
│       ├── file_normalizer.py      Normalisation PDF, TXT, EML, images
│       ├── email_ingester.py       Import IMAP avec sélection manuelle
│       ├── dossier_router.py       Routage automatique vers le dossier
│       └── app_password_guide.py   Guide mots de passe d'application
├── examples/                       3 courriers fictifs pour tester
└── data/
    └── dossier.json                Votre dossier (local, jamais partagé)

Modèle utilisé : Claude Opus (Anthropic) via l'API officielle.
Vos données : stockées uniquement en local dans data/dossier.json. Rien n'est envoyé à un tiers, seulement les textes des courriers à l'API Anthropic pour analyse.


Tester avec les exemples fournis

python main.py ajouter examples/courrier_01_caf_pieces_manquantes.txt
python main.py ajouter examples/courrier_02_cpam_remboursement_refuse.txt
python main.py ajouter examples/courrier_03_caf_trop_percu.txt
python main.py statut
python main.py conseil
python main.py repondre 2

Pourquoi ce projet ?

L'objectif : montrer qu'une IA bien promptée peut simplifier des démarches administratives qui touchent des millions de personnes — sans application SaaS, sans abonnement, juste du code ouvert.


Feedback & contributions

Les retours sont les bienvenus via GitHub Issues.

PRs bienvenues pour :

  • Support d'autres organismes (Pôle Emploi, CARSAT, impôts...)
  • Export des réponses en .docx
  • Intégration calendrier pour les échéances

Licence

MIT — libre d'utilisation, de modification et de redistribution.

About

Agent IA qui analyse vos courriers CAF/CPAM/URSSAF/Autres, génère des réponses administratives et mémorise votre dossier — Claude API + Streamlit

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages