README.md

DecodeChess‑IA — Doctor Linux

Analizador de partidas con Motor + Machine Learning (RandomForest) listo para Hugging Face Spaces.

¿Qué hace?

• Repara y lee PGN (toma la primera partida válida).
• Entrena automáticamente un modelo ML al iniciar (si no existe).
• Analiza jugada por jugada con Stockfish (tiempo configurable).
• Predice la categoría ML (Best, Good, Inaccuracy, Mistake, Blunder) y genera explicación.
• Devuelve PGN anotado y CSV por jugada.

Archivos necesarios

app.py
requirements.txt
apt.txt        # instala stockfish
runtime.txt    # python-3.11
README.md

Despliegue en Hugging Face

1. Crea un Space tipo Gradio.
2. Sube todos los archivos a la raíz del repo.
3. El Space instalará stockfish (vía apt.txt) y se iniciará el entrenamiento rápido.
4. Una vez corra, pega tu PGN y haz clic en Analizar con IA.

Local

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python app.py

El entrenamiento rápido genera un modelo RandomForest usando posiciones analizadas con Stockfish en poco tiempo (no requiere dataset previo). Puedes reemplazarlo luego con tu propio model_rf.joblib si lo deseas.