개발 환경 생성#
Xinference 개발에 필요한 환경을 설정하는 것은 코드 수정을 시작하기 전에 매우 중요합니다. 여기에는 Git 사용법 숙지, 독립적인 환경 구축, Xinference 설치 및 프론트엔드 컴파일이 포함됩니다.
Git 사용 방법#
문제를 수정해야 하거나, 기능을 추가하거나, 문서를 개선해야 할 때 GitHub와 Xinference 코드베이스에 익숙해지는 것이 중요합니다.
새로운 사용자에게 Git 사용은 Xinference 개발에 참여하는 가장 두려운 측면 중 하나입니다. 금방 압박감을 느낄 수 있지만, 아래 가이드는 프로세스를 간소화하고 잠재적 문제를 줄이는 데 도움이 될 것입니다. 해결하기 어려운 문제가 발생하면 커뮤니티에서 도움을 요청하시기 바랍니다.
Xinference의 코드는 GitHub 에 호스팅되어 있습니다. Xinference 코드 기여에 참여하려면 무료 GitHub 계정 을 등록해야 합니다. 우리는 Git 을 사용하여 버전 관리를 하며, 모두가 프로젝트 개발에 함께 참여할 수 있습니다.
GitHub 가이드 를 참고하여 git을 설치하고, SSH 키를 설정하며, git을 구성할 수 있습니다. 이러한 단계를 완료하여 로컬 저장소와 GitHub가 정상적으로 작동하도록 해야 하며, 이후 작업이 원활히 진행될 수 있습니다.
다음은 Git을 학습하기에 좋은 자료들입니다:
참고
git clone 명령으로 코드를 클론할 때 속도가 느리다면, 아래 명령어를 사용하여 프록시를 추가할 수 있습니다.
export https_proxy=YourProxyAddress
Create an isolated environment.#
Xinference를 공식 설치하기 전에, Conda를 사용하여 격리된 환경을 생성하여 후속 작업을 용이하게 하는 것을 권장합니다.
conda create --name xinf
conda activate xinf
``xinf``은 사용자 정의 Conda 환경 이름으로 대체할 수 있습니다.
그런 다음 새로 생성된 Conda 환경에 Python과 Node.js(npm)를 설치해야 합니다. 명령어는 다음과 같습니다:
conda install python=3.12
conda install nodejs
소스 코드로 설치#
시작하기 전에 저장소를 클론했는지 확인하세요. 저장소를 inference 라는 디렉토리에 클론했다고 가정하고, 해당 디렉토리로 이동한 후(그곳에는 setup.cfg 와 setup.py 파일이 있습니다) 다음 명령을 실행하세요:
pip install -e .
xinference-local
명령이 성공적으로 실행되면, 이제 Xinference를 정상적으로 사용할 수 있습니다. 사용 방법에 대한 자세한 내용은 `사용 방법 <https://inference.readthedocs.io/zh-cn/latest/getting_started/using_xinference.html>`__을 참조하십시오.
오류가 발생하거나 실행 중에 멈추는 경우, 다음 단계인 프론트엔드 컴파일을 수행해야 합니다.
프론트엔드 컴파일#
먼저 inference/xinference/ui/web/ui 디렉토리로 이동한 후, 다음 명령어를 실행하여 캐시를 삭제합니다:
npm cache clean
명령 실행이 실패하면 --force 옵션을 추가해 볼 수 있습니다.
참고
만약 해당 디렉토리에 이미 node_modules 폴더가 존재한다면, 먼저 수동으로 해당 폴더를 삭제하는 것을 권장합니다.
그런 다음 해당 디렉토리에서 다음 명령을 실행하여 프론트엔드 컴파일을 수행합니다:
npm install
npm run build
첫 번째 명령 실행이 실패하더라도 --force 옵션을 추가하여 해결을 시도할 수 있습니다.
프론트엔드를 컴파일한 후, setup.cfg``와 ``setup.py 파일이 포함된 디렉토리로 돌아가서 pip install -e . 명령어로 Xinference를 설치할 수 있습니다.