Cómo solucionar un KeyError en Argos Translate y Stanza

Al ejecutar el comando argos-translate --from-lang en --to-lang es "Hello World.", es posible que encuentres un error inesperado. El traceback muestra un KeyError: 'packages', lo cual indica que algo ha fallado durante la inicialización de los procesadores lingüísticos dentro del pipeline.

El problema no es un bug complejo de Argos Translate, sino un conflicto clásico de versiones en tu entorno virtual. Al revisar los mensajes del resolver de dependencias de pip, se confirma que la versión instalada de stanza (1.13.0) no coincide con lo que exige Argos Translate (1.11.1).

Dado que Stanza es fundamental para segmentar las oraciones antes de traducir, esta incompatibilidad provoca el fallo en tiempo de ejecución. La solución es directa: volver a la versión compatible.

El procedimiento de corrección

Para arreglar esto en tu entorno virtual, debes desinstalar y reinstalar los paquetes con las versiones correctas:

1. Dentro del mismo venv, ejecuta para limpiar la versión actual de Stanza:

pip uninstall stanza -y

2. A continuación, instala la versión exacta requerida por Argos:

pip install stanza==1.10.1

3. Finalmente, para evitar residuos, reinstala Argos Translate:

pip install --force-reinstall argostranslate==1.11.1

Una vez completados estos pasos, puedes ejecutar el comando de traducción nuevamente y deberías ver que funciona correctamente.