GitHub 소스코드 실행 가이드 (Windows 중심)

💻 GitHub 소스코드 실행 가이드 (Windows 중심)

GitHub에 올라온 프로그램을 Windows PC에서 직접 실행하는 방법을 단계별로 안내합니다.
(💡 Linux 사용자는 Git과 Python 설치 과정이 다르며, 여기서는 간단히 언급만 합니다.)

---

1️⃣ Git 설치

Git은 소스코드를 내려받기 위한 버전 관리 툴입니다. Windows에는 기본 포함되지 않으므로 먼저 설치합니다.

• 공식 Git 다운로드 페이지에서 Windows 버전 설치 파일 다운로드
• 설치 마법사에서 특별한 변경 없이 Next 버튼 클릭

설치 확인:

git --version

---

2️⃣ 저장소 내려받기 (Clone)

1. 명령 프롬프트 실행: Win + R → cmd 입력 → 엔터
2. 저장할 폴더로 이동(선택):

   D:
   cd projects

3. 저장소 복제 (URL은 실제 GitHub 주소로 교체):

   git clone <저장소_URL>

4. 프로젝트 폴더로 이동:

   cd z_Codex_01

---

3️⃣ Python 및 라이브러리 설치

이 프로그램은 Python + PySide6 기반입니다.

1. Python 공식 사이트에서 최신 버전 다운로드
2. 설치 시 "Add Python to PATH" 옵션 체크 필수
3. PySide6 설치:

   pip install PySide6

---

4️⃣ 프로그램 실행

프로젝트 폴더 안에서 다음 명령어 입력:

python -m backend.main

💡 backend/main.py 파일을 메인으로 실행한다는 의미입니다.

---

📌 전체 절차 요약

1. Git 설치 → git --version으로 확인
2. git clone으로 소스코드 받기
3. Python 설치 → pip install PySide6
4. python -m backend.main 실행

---

ⓒ 2025 AI교육연구회 withseok. All rights reserved. (위드석) | 상업적 이용금지 | 위드석 | AI교육연구회