Crear entorno de desarrollo#
Antes de realizar cualquier modificación de código, es crucial establecer el entorno necesario para el desarrollo de Xinference. Esto incluye familiarizarse con el uso de Git, crear un entorno independiente, instalar Xinference y compilar la parte del frontend.
Uso de Git#
Cuando tienes un problema que necesita ser reparado, una mejora que debe agregarse o documentación que necesita ser mejorada, es importante estar familiarizado con GitHub y el repositorio de código de Xinference.
Para los nuevos usuarios, usar Git es uno de los aspectos más intimidantes al participar en el desarrollo de Xinference. Pronto puede volverse abrumador, pero la siguiente guía ayudará a simplificar el proceso y reducir posibles problemas. Si encuentras dificultades, no dudes en buscar ayuda en la comunidad.
El código de Xinference está alojado en GitHub. Para contribuir al código de Xinference, necesitas registrarte en una cuenta gratuita de GitHub. Usamos Git para el control de versiones, de modo que todos puedan participar en el desarrollo del proyecto.
Puedes consultar la Guía de GitHub para instalar git, configurar la clave SSH y ajustar git. Debes completar estos pasos para asegurarte de que tu repositorio local y GitHub funcionen correctamente, de modo que el trabajo posterior pueda continuar sin problemas.
Aquí tienes algunos buenos recursos para aprender Git:
Nota
Si la velocidad es lenta al clonar el código con git clone, se puede agregar un proxy mediante los siguientes comandos.
export https_proxy=YourProxyAddress
Crea un entorno aislado.#
Antes de la instalación oficial de Xinference, se recomienda utilizar Conda para crear un entorno aislado que facilite las operaciones posteriores.
conda create --name xinf
conda activate xinf
xinf se puede reemplazar por el nombre personalizado del entorno Conda.
Posteriormente, es necesario instalar Python y Node.js (npm) en el nuevo entorno de Conda. Los comandos son los siguientes:
conda install python=3.12
conda install nodejs
Instalación desde el código fuente#
Antes de comenzar, asegúrese de haber clonado el repositorio. Suponiendo que lo ha clonado en un directorio llamado inference, ingrese a este directorio, donde se encuentran los archivos setup.cfg y setup.py, y ejecute el siguiente comando:
pip install -e .
xinference-local
Si el comando se ejecuta correctamente, ya podrá usar Xinference con normalidad. Para más detalles sobre el tutorial de uso, consulte Uso.
Si aparece un error o se congela durante la ejecución, será necesario realizar el siguiente paso de compilación del frontend.
Compilación front-end#
Primero, ingrese al directorio inference/xinference/ui/web/ui, luego ejecute el siguiente comando para limpiar el caché:
npm cache clean
Si la ejecución del comando falla, puede intentar agregar la opción --force.
Nota
Si ya existe una carpeta node_modules en ese directorio, se recomienda eliminarla manualmente primero.
Luego, ejecute el siguiente comando en ese directorio para compilar el frontend:
npm install
npm run build
Si el primer comando falla en su ejecución, aún puede intentar solucionarlo agregando la opción --force.
Después de compilar el frontend, puede volver al directorio que contiene los archivos setup.cfg y setup.py e instalar Xinference mediante pip install -e ..