Geniusia_v2/geniusia2/QUICKSTART.md

Guide de Démarrage Rapide - RPA Vision V2

Ce guide vous permet de démarrer avec RPA Vision V2 en quelques minutes.

Installation Express (5 minutes)

# 1. Cloner ou naviguer vers le projet
cd geniusia2

# 2. Lancer l'installation automatique
./setup.sh

# 3. C'est tout ! Le script configure tout automatiquement

Premier Lancement (2 minutes)

# Activer l'environnement virtuel
source venv/bin/activate

# Lancer l'application
python3 main.py

L'interface graphique s'ouvre automatiquement.

Première Utilisation (10 minutes)

Étape 1: Configuration de la Liste Blanche

Avant de commencer, ajoutez les applications que vous souhaitez automatiser:

1. Cliquez sur "Gérer Liste Blanche"
2. Ajoutez une application de test (ex: "Firefox", "gedit")
3. Confirmez l'ajout

⚠️ Important: Ne jamais ajouter d'applications sensibles (banque, admin système)

Étape 2: Mode Shadow (Apprentissage)

1. Cliquez sur "Start"
2. Le mode 👀 Shadow est activé par défaut
3. Effectuez une tâche répétitive dans l'application autorisée
4. Le système observe et apprend silencieusement
5. Répétez la tâche au moins 20 fois

Exemple de tâche simple:

• Ouvrir Firefox
• Cliquer sur la barre d'adresse
• Taper "example.com"
• Appuyer sur Entrée

Étape 3: Transition vers Mode Assisté

Après ≥20 observations avec ≥95% de concordance:

1. Une notification propose le passage en mode 🤝 Assisté
2. Acceptez la transition
3. Le système suggère maintenant les actions
4. Validez avec Entrée ou rejetez avec Échap

Étape 4: Mode Autopilot (Automatisation)

Après ≥20 validations avec ≥95% de concordance:

1. Une notification propose le passage en mode 🤖 Autopilot
2. Acceptez la transition
3. Le système exécute automatiquement la tâche
4. Surveillez les notifications de succès/échec

Raccourcis Essentiels

Raccourci	Action
Ctrl+Pause	🛑 Arrêt d'urgence
Entrée	✅ Valider suggestion
Échap	❌ Rejeter suggestion
Alt+C	🔧 Corriger action

Tableau de Bord

Appuyez sur Ctrl+D pour ouvrir le tableau de bord:

• Vue d'ensemble des tâches apprises
• Métriques de performance (confiance, concordance)
• Historique des corrections
• Alertes et recommandations

Cas d'Usage Simples

1. Automatiser une Recherche Web

Tâche: Rechercher "météo Paris" sur Google

1. Mode Shadow: Effectuez la recherche 20 fois
2. Mode Assisté: Validez les suggestions 20 fois
3. Mode Autopilot: Laissez le système faire

Temps d'apprentissage: ~10 minutes

2. Remplir un Formulaire

Tâche: Remplir un formulaire avec des données fixes

1. Mode Shadow: Remplissez le formulaire 20 fois
2. Mode Assisté: Validez les suggestions
3. Mode Autopilot: Automatisation complète

Temps d'apprentissage: ~15 minutes

3. Copier-Coller entre Applications

Tâche: Copier du texte de Firefox vers LibreOffice

1. Ajoutez Firefox et LibreOffice à la liste blanche
2. Mode Shadow: Effectuez l'opération 20 fois
3. Mode Assisté: Validez les suggestions
4. Mode Autopilot: Automatisation

Temps d'apprentissage: ~15 minutes

Résolution de Problèmes Rapide

Le système ne détecte pas mes actions

• Vérifiez que l'application est dans la liste blanche
• Assurez-vous que le mode Shadow est actif
• Vérifiez les logs dans le tableau de bord

Les suggestions sont imprécises

• Fournissez plus d'exemples en mode Shadow (>20)
• Vérifiez que l'UI n'a pas changé
• Ajustez les seuils dans core/config.py

Latence élevée

• Vérifiez que le GPU est utilisé
• Utilisez un modèle plus léger (qwen2.5-vl:3b)
• Réduisez la résolution de capture

Erreur "Application not whitelisted"

• Ajoutez l'application à la liste blanche
• Vérifiez le titre exact de la fenêtre
• Redémarrez l'application

Prochaines Étapes

1. Explorez le tableau de bord: Ctrl+D pour voir les métriques
2. Testez le rollback: Ctrl+Z pour annuler les 3 dernières actions
3. Personnalisez la config: Éditez core/config.py
4. Lisez la doc complète: README.md

Conseils de Sécurité

✅ À FAIRE:

• Tester en mode Shadow avant Autopilot
• Surveiller le tableau de bord régulièrement
• Sauvegarder data/ périodiquement
• Utiliser l'arrêt d'urgence (Ctrl+Pause) si nécessaire

❌ À NE PAS FAIRE:

• Ajouter des applications sensibles à la liste blanche
• Laisser tourner en Autopilot sans surveillance
• Modifier les fichiers dans data/ manuellement
• Désactiver les mécanismes de sécurité

Support

• Documentation: README.md
• Architecture: .kiro/specs/rpa-vision-v2/design.md
• Logs: data/logs/ (chiffrés)
• Métriques: Tableau de bord (Ctrl+D)

---

Temps total pour être opérationnel: ~20 minutes

Temps pour première automatisation: ~30 minutes

Bon apprentissage ! 🚀