Troubleshooting¶
| Problema | Solución |
|---|---|
ModuleNotFoundError: No module named 'src' |
pip install -e . en proyecto root |
pytest: command not found |
pip install -e ".[dev]" |
Tesseract not found |
Ver README.md o TESSERACT_CMD en .env |
SpaCy model missing |
python -m spacy download es_core_news_lg |
PaddleOCR: No module named 'paddle' |
pip install paddlepaddle==2.6.2 paddleocr==2.7.3 |
PaddleOCR: Unknown argument: use_gpu/show_log |
Tienes paddleocr 3.x. Fix: pip uninstall paddleocr paddlex -y && pip install paddleocr==2.7.3 |
numpy.core.multiarray failed to import |
Conflicto numpy 2.x. Fix: pip install "numpy>=1.24.0,<2.0.0" |
opencv requires numpy>=2 |
Downgrade: pip install "opencv-python-headless>=4.8.0,<4.10.0" |
mypy strict errors |
Type hints faltantes. mypy src/ --show-error-codes |
SQLite FTS5 not available |
python -c "import sqlite3; print(sqlite3.sqlite_version)" >= 3.9.0 |
Tests lentos |
pytest -m "not slow" |
Pre-commit hooks fallan |
pre-commit run --all-files |
Dependencias críticas (versiones fijadas)¶
- Python 3.12.4 (NO 3.14 — SpaCy/Pydantic v1 incompatible)
- paddleocr==2.7.3 + paddlepaddle==2.6.2
- numpy>=1.24.0,<2.0.0
- opencv-python-headless>=4.8.0,<4.10.0
Analytics (Umami)¶
Desactivar: ANALYTICS_ENABLED=0 antes de ejecutar Streamlit.
Dashboard: https://analytics.sprintjudicial.com