Esta página trata de la ruta más corta desde cero hasta tu primer entorno de EvoX en funcionamiento : completar la instalación y la configuración básica con los mínimos comandos posibles y, después, verificar con una importación y un ejemplo mínimo que EvoX realmente puede ser invocado por tu tarea. Recuerda una frase:que se instale no significa que funcione. Solo cuando los cuatro pasos produzcan una salida real se puede considerar completada la puesta en marcha.
Paso 1: primero aislar, luego instalar
Antes de instalar cualquier paquete, crea un entorno de Python independiente con venv o conda. Los paquetes del entorno global se comparten entre todos los proyectos y, si las versiones entran en conflicto, el costo de diagnóstico es altísimo; un entorno independiente equivale a reservar una mesa de laboratorio exclusiva para EvoX: si se rompe, se elimina y se reconstruye sin afectar a otros proyectos.
- Prioriza el aislamiento del entorno: primero crea el entorno con python -m venv .venv y luego actívalo (en Windows, el script activate dentro del directorio Scripts).
- Actualiza primero el gestor de paquetes: tras activar, ejecuta primero pip install -U pip para evitar errores de resolución de dependencias con versiones antiguas de pip.
Paso 2: instalar EvoX
La instalación suele ser un solo comando: pip install evox; también puedes instalarlo con conda o desde el código fuente.El nombre del paquete, la versión y la fuente de descarga siempre deben regirse por la publicación oficial: los nombres de paquete de distintas fuentes pueden diferir en una o dos letras, y un error tipográfico haría que instales otro paquete o una versión antigua incompatible. Que no haya errores en rojo durante la instalación solo indica que "se instaló", lo cual no significa que "funcione", así que no te detengas en este paso.
Paso 3: reducir la configuración básica al mínimo
En la primera puesta en marcha no hace falta revisar todos los parámetros; basta con confirmar cuatro puntos de partida: si la versión de Python cumple con los requisitos oficiales, si las versiones de las dependencias son compatibles entre sí, si el experimento usa CPU o GPU, y si la semilla aleatoria está fijada. Los dos primeros determinan si el programa puede ejecutarse; los dos últimos, si los resultados pueden reproducirse.
Paso 4: cerrar con la verificación
La forma más fiable de validar no es ver si hay texto rojo en la terminal, sino hacer que EvoX se ejecute de verdad: primero import evox e imprime la versión para confirmar que el paquete se carga realmente en este entorno; después ejecuta un ejemplo mínimo o completa una iteración evolutiva para confirmar que la tarea puede invocarlo correctamente. Solo cuando ambos produzcan una salida real se puede dar por completada la configuración del entorno.
Deja que la IA ayude, pero tú supervisas
Puedes indicar a la IA tu sistema operativo, versión de Python y hardware para que genere los comandos de instalación, configuración y diagnóstico correspondientes, lo que ahorra mucho tiempo de consulta de documentación. Pero cuidado: los nombres de paquete, las combinaciones de versiones y las operaciones a nivel de sistema que proponga la IA deben verificarse con la documentación oficial y la matriz de versiones antes de ejecutarse, especialmente los comandos que modifiquen la configuración del sistema o desinstalen dependencias.
Límites de reproducibilidad: registra los comandos de instalación, el archivo de dependencias del entorno y los números de versión. La consecuencia más común de mezclar entornos es que "funciona en mi máquina, pero falla en otra", y el registro es el único seguro de bajo costo.
