Files

Dom a27b74cf22 v1.0 - Version stable: multi-PC, détection UI-DETR-1, 3 modes exécution

- Frontend v4 accessible sur réseau local (192.168.1.40)
- Ports ouverts: 3002 (frontend), 5001 (backend), 5004 (dashboard)
- Ollama GPU fonctionnel
- Self-healing interactif
- Dashboard confiance

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-29 11:23:51 +01:00

1.9 KiB

Raw Blame History

Guide FAISS Rebuild Propre

Auteur : Dom, Alice Kiro - 22 décembre 2025

Vue d'ensemble

Le système FAISS Rebuild Propre permet de maintenir un index FAISS propre et cohérent en éliminant la pollution causée par l'accumulation de vecteurs obsolètes.

Problème résolu

Avant : Pollution d'index

Les prototypes mis à jour s'accumulent dans l'index FAISS
Anciens vecteurs obsolètes restent présents
Dégradation progressive de la qualité de matching

Après : Index propre

Stratégie "1 prototype = 1 entrée"
Clear complet + reindex depuis source canonique
Index cohérent reflétant exactement les prototypes actuels

Utilisation

Script utilitaire

# Mode simulation
python3 rebuild_faiss_simple.py --dry-run --verbose

# Rebuild réel
python3 rebuild_faiss_simple.py --verbose

# Index IVF
python3 rebuild_faiss_simple.py --index-type IVF

API programmatique

from core.embedding.faiss_manager import FAISSManager

manager = FAISSManager(dimensions=512)
items = [("id1", vector1, {"meta": "data1"})]
count = manager.reindex(items, force_train_ivf=True)

Formats supportés

v1: template.embedding_prototype (liste)
v2: embedding.vector_id (fichier)
legacy: screen_template.embedding_prototype_path

Quand déclencher

✅ Recommandé:

Après apprentissage réussi
Mise à jour de prototypes validée
Maintenance périodique

❌ À éviter:

Pendant l'exécution
Mises à jour fréquentes
Index vide

Troubleshooting

Rebuild échoue

ERROR - FAISS reindex failed: vector dimensions mismatch

Solution: Vérifier cohérence des dimensions

Performance dégradée

Solutions:

Utiliser index IVF pour gros volumes
Traitement par batch
Monitoring mémoire

Configuration

manager = FAISSManager(
    dimensions=512,
    index_type="IVF",
    metric="cosine",
    use_gpu=True
)

1.9 KiB Raw Blame History