OS별 시작 가이드
Windows
WSL, NVIDIA 드라이버/CUDA, Python, Docker, Ollama
macOS
Homebrew, Python, MPS, Docker, Ollama
Ubuntu 24.04
apt, NVIDIA/CUDA, Python, Docker, Ollama
권장 진행 순서
- OS 공통 기본 도구 설치 (
git,vscode,nodejs,uv) - GPU 사용 시 드라이버/CUDA 구성 (Windows, Ubuntu)
- LLM 실습 도구 설치 (
ollama,rancher-desktop/docker) - 프로젝트 단위 환경은
UV Env에서 별도로 생성
설치 점검 목록
- 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
- 설치 후 버전 확인 명령어(
--version)를 실행해 정상 설치를 검증했습니다. - PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
- 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.
문제 해결 가이드
- 설치 파일이 실행되지 않으면 관리자 권한으로 다시 실행합니다.
- 명령어가 인식되지 않으면 터미널을 새로 열고 PATH 반영 여부를 확인합니다.
- 버전이 맞지 않으면 기존 설치를 정리한 뒤 권장 버전으로 재설치합니다.
- 설정 변경 후 동작이 이상하면 시스템 재시작 후 다시 확인합니다.