# Commandes Utiles - RPA Vision V3

## 🚀 Démarrage Rapide

```bash
# Status ultra-rapide
./quick_status_v3.sh

# Status détaillé
bash rpa_vision_v3/status.sh

# Voir l'index de documentation
cat rpa_vision_v3/INDEX.md
```

## 🔧 Configuration

```bash
# Activer venv geniusia2 (recommandé)
source geniusia2/venv/bin/activate

# Ou installer dans nouveau venv
cd rpa_vision_v3
bash install_dependencies.sh

# Installer seulement CLIP
bash install_clip.sh
```

## 🧪 Tests

```bash
# Test CLIP simple (rapide)
bash rpa_vision_v3/test_clip.sh

# Test CLIP complet
cd rpa_vision_v3/examples
python3 test_clip_simple.py

# Test CLIP détaillé (session précédente)
python3 test_clip_embedder.py

# Tests unitaires
cd rpa_vision_v3
pytest tests/

# Tests avec coverage
pytest tests/ --cov=core --cov-report=html
```

## 📚 Documentation

```bash
# Voir status Phase 2
cat rpa_vision_v3/PHASE2_CLIP_COMPLETE.md

# Voir notes de session
cat rpa_vision_v3/SESSION_22NOV_CLIP.md

# Voir guide de reprise
cat rpa_vision_v3/NEXT_SESSION.md

# Voir index complet
cat rpa_vision_v3/INDEX.md

# Voir task list
cat rpa_vision_v3/docs/specs/tasks.md

# Voir design
cat rpa_vision_v3/docs/specs/design.md
```

## 🔍 Exploration du Code

```bash
# Voir structure du projet
tree rpa_vision_v3 -L 2

# Voir les modèles
ls -la rpa_vision_v3/core/models/

# Voir les embedders
ls -la rpa_vision_v3/core/embedding/

# Voir les tests
ls -la rpa_vision_v3/examples/
```

## 🐍 Python Interactif

```bash
# Activer venv
source geniusia2/venv/bin/activate

# Lancer Python
cd rpa_vision_v3
python3

# Dans Python:
>>> from core.embedding.clip_embedder import create_clip_embedder
>>> embedder = create_clip_embedder()
>>> emb = embedder.embed_text("Hello world")
>>> print(emb.shape)
(512,)
```

## 📊 Vérifications

```bash
# Vérifier Python
python3 --version

# Vérifier PyTorch
python3 -c "import torch; print('PyTorch:', torch.__version__)"

# Vérifier CLIP
python3 -c "import open_clip; print('OpenCLIP: OK')"

# Vérifier FAISS
python3 -c "import faiss; print('FAISS: OK')"

# Vérifier toutes les dépendances
python3 -c "import torch, open_clip, faiss, numpy, PIL; print('✅ Toutes les dépendances OK')"
```

## 🔨 Développement

```bash
# Formater le code
cd rpa_vision_v3
black core/ tests/ examples/

# Vérifier types
mypy core/

# Linter
pylint core/

# Compter lignes de code
find core/ -name "*.py" | xargs wc -l
```

## 📦 Gestion des Fichiers

```bash
# Voir les fichiers créés cette session
cat rpa_vision_v3/FILES_CREATED_SESSION_22NOV.md

# Voir tous les fichiers Python
find rpa_vision_v3 -name "*.py" -type f

# Voir tous les fichiers Markdown
find rpa_vision_v3 -name "*.md" -type f

# Voir tous les scripts
find rpa_vision_v3 -name "*.sh" -type f
```

## 🗑️ Nettoyage

```bash
# Supprimer fichiers temporaires
find rpa_vision_v3 -name "*.pyc" -delete
find rpa_vision_v3 -name "__pycache__" -type d -exec rm -rf {} +

# Supprimer images de test
rm -f rpa_vision_v3/examples/test_synthetic_ui.png
rm -f rpa_vision_v3/examples/synthetic_ui.png

# Supprimer embeddings de test
rm -rf rpa_vision_v3/examples/test_embeddings/
```

## 🔄 Git

```bash
# Voir status
git status

# Voir fichiers modifiés
git diff --name-only

# Voir différences
git diff rpa_vision_v3/

# Ajouter fichiers V3
git add rpa_vision_v3/

# Commit
git commit -m "Phase 2 CLIP Embedders complete"
```

## 📈 Statistiques

```bash
# Compter fichiers Python
find rpa_vision_v3 -name "*.py" | wc -l

# Compter lignes de code Python
find rpa_vision_v3/core -name "*.py" | xargs wc -l | tail -1

# Compter lignes de tests
find rpa_vision_v3/tests -name "*.py" | xargs wc -l | tail -1

# Compter lignes de documentation
find rpa_vision_v3 -name "*.md" | xargs wc -l | tail -1
```

## 🎯 Raccourcis Utiles

```bash
# Alias pour status rapide
alias v3status='./quick_status_v3.sh'

# Alias pour test CLIP
alias v3test='bash rpa_vision_v3/test_clip.sh'

# Alias pour activer venv
alias v3env='source geniusia2/venv/bin/activate'

# Alias pour aller dans V3
alias v3='cd rpa_vision_v3'
```

## 🆘 Dépannage

```bash
# Si erreur "module not found"
source geniusia2/venv/bin/activate

# Si erreur CUDA
export CUDA_VISIBLE_DEVICES=""  # Force CPU

# Si erreur mémoire
# Réduire batch size ou utiliser CPU

# Voir logs détaillés
python3 -v rpa_vision_v3/examples/test_clip_simple.py

# Debug mode
PYTHONPATH=. python3 -m pdb rpa_vision_v3/examples/test_clip_simple.py
```

## 📞 Aide

```bash
# Voir aide Python
python3 --help

# Voir aide pytest
pytest --help

# Voir aide pip
pip --help

# Voir documentation inline
python3 -c "from core.embedding.clip_embedder import CLIPEmbedder; help(CLIPEmbedder)"
```

---

**Astuce**: Ajoutez ces alias à votre `~/.bashrc` ou `~/.zshrc` pour un accès rapide !